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Feeling peckish? 


How are you enjoying the Junior Computer so far? Everything to 
satisfaction? Fine. In that case, you must be eager to digest Book 2, a 
complete menu of computer facts and programming material. 

Dig in, folks! 

Now that we’ve got the Junior Computer up and running (Book 1) it is 
time to construct and construe a number of ‘tools’ with which to operate 
the microprocessor as efficiently as possible. 

This is where chapter 5 comes in. It presents the programmer with such 
essential tools as the ‘editor’ and the ‘assembler’. These are highly effective 
as they enable typing errors to be corrected and additional instructions 
to be inserted at any point without having to re-enter the entire program. 
The programmer now no longer has to calculate displacements (during 
conditional branch instructions and absolute addresses (during jump in- 
structions) himself: ali these tiresome chores are dealt with automatically 
inside the Junior Computer’s EPROM. 

Chapter 6 teaches the Junior Computer to ‘sing’. It includes several circuits 
which, together with the peripheral interface adapter (PIA), turn the JC 
into a keyboard instrument. Via the PIA the computer controls a loud- 
speaker and in Book 3 it will be seen to use the same method to operate 
a printer. 

The remaining chapters (7, 8 and 9) provide a detailed description of the 
monitor, the editor and the assembler, respectively, all of which combine 
to form the EPROM brain. Once the user knows exactly how the Junior 
Computer ‘ticks’, he/she will be able to write suitable programs personally. 
Various subroutines introduced in the book will then be of great 
assistance. 

Finally, the appendix gives a clear and coherent summary of all the 
availabie subroutines and listings. 

After reading Book 2 and mastering the contents, the programmer will be 
ready to add a printer and a cassette interface to the standard Junior Com- 
puter. These peripheral devices, to be ‘served up’ in Book 3, will transform 
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the machine into a full-fledged personal computer. Then the Junior 
Computer wiil have well and truly ‘outgrown’ its name. 


The authors. 


P.S. Since nothing in this world is perfect — including the Junior Com- 
puter! — we will lend a willing ear to any suggestions or comments 
that readers might care to make. 


Contents 
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The Editor and the Assembler 


Cheater Gch eee ks bow wt Bhs ie eG er eel ocean 
The Peripheral Interface Adapter or PIA 
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The Monitor program — Basic ‘housekeeping’ software 


CAptGr So. see Ais 5 oi eae BE, Uw a a 
The Editor program — The ‘intelligence’ behind simple program entry 


CART CE S. icg ae! a areccc oe ee he wos eS ee eke See 
The Assembler program — Tidying up the edited program 


PADDONGI OT hic kite eed cicero ANOLE E ES 
The program listing of the EPROM 


ADDONGIN 2 ces ea AA Ne oe oe Ee BE eee 6 eo 
Listings of the programs used in chapters 5 and 6 





The Editor 
and the Assembler 


Typing in a program is a dull, irksome occupation. As was 
shown in Book 1, each individual instruction has to be entered, 
one byte at a time. But before this can be done, a fair amount 
of paper work is involved: 
— subroutine start addresses, 
— displacements inherent to conditional branch instructions 
and 
— absolute addresses inherent to unconditional branch instruc- 
tions (jump instructions) all have to be calculated first. 
When the entire program has finally been entered into the 
computer, it has to be checked for typing errors. Supposing one 
byte happened to be left out somewhere in the middle of the 
program. Does this mean retyping the whole lot? No — thanks 
to the editor and the assembler — it doesn’t! 
The editor and the assembler are both stored inside the Junior 
Computer’s EPROM. The former allows new instructions to be 
inserted at any given point in the program, even after entry; 
in addition, it tracks down instructions and, if necessary, deletes 
them. Thus, the keyboard and the editor act as a ‘pencil and 
rubber’, so to speak, while data is being entered. 
The editor also permits the programmer to type in symbolic 
addresses, called ‘labels’. After this, the assembler steps in to 
calculate subroutine start addresses, displacements in the event 
of conditional branch instructions and absolute addresses for 
jump instructions, and all without any human help! As a result, 
program errors are reduced to a minimum and the user is saved 
a great deal of unnecessary labour. 


The Editor 


Having studied the Junior Computer Book !, you should be familiar with 
most of the instructions and address modes appertaining to the 6502 
microprocessor. Various program examples were given which showed how 
easy it is to program the JC. Up to now the data entered consisted en- 
tirely of hexadecimal numbers. When the AD key was depressed the JC 
‘knew’ it had to interpret the following key information as addresses. 
Pressing the DA key, on the other hand, told it to store any entered data 
in the actual address location displayed. 

As far as short programs are concerned, such as those given in Book I, this 
type of data entry is quite adequate. When more extensive programs are 
involved however (with a fength of, say, several hundred bytes), typing 
errors can occur frequently and correcting them can become a very tedious 
procedure. What do you do, for instance, if a few instructions have been 
omitted from the middle of the program? Normally, this would mean 
having to re-enter a large part of the program from the correction onwards. 
What a waste of time and effort! Redundant instructions can be removed 
by replacing them with NOP instructions (op-code EA), which is making 
very poor use of the computer’s memory space. Think how irritating it 
would be, if, when entering a long program, you run out of memory! 
Fortunately, this can now be avoided with the aid of one of the JC’s 
greatest assets: the EDITOR. This enables bytes to be inserted or deleted 
anywhere within the memory area. When bytes are to be inserted, the 
computer makes room for them by moving a data block further down in 
the program. When bytes are to be deleted, the data block is moved up to 
‘close the gap’. Block transfers and their respective programs were men- 
tioned in Book | during the description of indexed and indirect address- 
ing. 

In short, the editor can save a lot of time and trouble where program 
correction is concerned. Exactly how simple it is to enter and correct 
programs will be seen later on in this chapter. 


The Assembler 


Another indispensable aid towards simple, error-free, high-speed program 
entry is the assembler. As you will remember from Book I, branch instruc- 
tions are often used. Before the displacement value of a branch instruction 
can be calculated, it is important to know the start and destination ad- 
dresses. It is only then that the monitor routine BRANCH (start address 
1FD5) can calculate the displacement. The same applies to the instructions 
JSR and JMP —the true jump address must be known. Thus, before a 
program can be keyed in, you must be familiar with the absolute addresses 
of the branch and jump instructions. Obtaining the correct addresses 
numerically involves a great deal of writing. A more efficient method is to 
let the assembler in the monitor program take care of it. 

It fulfils the task quickly and simply and, above all, accurately. All that is 
required is to depress the GO key and the computer will calculate all the 
displacement values, absolute addresses of jump instructions and the 
subroutine start addresses by itself. Incredible as it may seem, the JC 
takes this painstaking job off the programmer’s hands and completes it ina 
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matter of seconds. What is more, the assembler, the editor and several 
other routines only occupy 1k of EPROM! This is possible as the 6502 
microprocessor happens to have highly effective and powerful instructions 
and numerous address possibilities. 

The time has now come to take a closer look at the editor and assembler 
and find out exactly how to use them. 


Editing and assembly from start to finish 


Before the editor and assembler can be put into operation, we need to 

develop a program to be run on the Junior Computer. The program should 

perform the following: 

— convert an 8-bit binary number into decimal 

— display the binary number in hexadecimal form next to the decimal 
figure 

— use the keyboard to enter the hexadecimal number 

— use monitor routines to scan the six digit display. 

The object of the exercise is to write a program as quickly as possible, free 

of errors and which meets the above requirements. It is best to start by 

constructing an algorithm which outlines the conversion of an 8-bit binary 

number (00... FF) into decimal (01g... 25519). This is shown in figure 

1. As can be seen, the algorithm is expressed in words. It should 

be mentioned at this stage that it is always a good idea to write down a 

complicated program in words first! Then a rough flow chart can be 

produced leading to the actual program. 

During the binary to decimal conversion program, BINDEC, a counter is 

reset to zero and the hexadecimal number to be converted is stored inside 

a buffer. The actual procedure is as follows: 

1. The value GA (=101q) is repeatedly subtracted from the hexadecimal 
number in the buffer until the buffer contents become negative. After 

each subtraction the counter is incremented by one. This means that in the 

end the counter will show how many subtractions were carried out before 

the result became negative. 

2. In order to represent a negative 8-bit number in an 8-bit processor, a 
16-bit buffer is required consisting of two memory locations. 

3. If the most significant digit of the 16-bit number is a ‘one’, the result of 
the subtraction was negative and the program branches to the section 

labelled UNITS. Here the processor will add @A to the negative buffer 

contents. The result is a figure which can assume a value between @...9 

and is the number of units of the decimal answer. 

4. The contents of the counter are stored in the 16-bit buffer, after which 
the counter is once again reset. The processor will now continue to 

subtract @A from the buffer contents until a negative result is obtained. 

The counter will again indicate the number of subtractions that were 

carried out. 

5. When @A is then added to the negative buffer contents, a figure is 
obtained which can assume any value between @...9 and which 

represents the tens of the decimal answer. 

6. The counter will now contain a figure with a value from @...2, 
representing the hundreds of the decimal answer. 


BINDEC 


counter — @@ 


hexadecimal 
number > buffer 


subtract GA (= 1019) 
from buffer 


resuit yes 
negative UNITS 
? 
no 


increment : 
counter by one add @A (= 104g) correction! 
to result 
result is 
X.10° 


counter > 
buffer 


counter > 


subtract GA (=191g) 
from buffer 





















result yes 


Negative 
? 
no 


increment 
counter by one add @A (= 194g) 


to result 


result is correction! 
Y.10 


80915 -5-1 


counter 
contents = 7.167 


Figure 1. Before we can work with the editor and the assembler, let us develop a 
program that converts a hexadecimal value into a decimal. The editor and the 
assembler will be seen to intervene as soon as the program is written in memory. The 
flow chart contains a conversion algorithm. 
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This is all very well in theory, but of course only a practical example can 
prove that the algorithm really works. Let us therefore convert the 
hexadecimal value 0991 into decimal in the same way as the program given 
in figure 1, 


number buffer: 0091 counter: @¢@ 
— @A 

number buffer: 0087 counter: @1 
— OA 

number buffer: @07D counter: @2 
—- QA 

number buffer: 0073 counter:: G3 
— @A 

number buffer: @069 counter: @4 
— QA 

number buffer: Q@O5F counter: @5 
— OA 

number buffer: 0055 counter: @6 
— OA 

number buffer: @04B counter: 07 
— OA 

number buffer: 0041 counter: @8 
— OA 

number buffer: $037 counter: @9 
— @A 

number buffer: Q@02D counter: @A 
— OA 

number buffer: 0023 counter: @B 
— A 

number buffer: 0019 counter: @C 
—~ @A 

number buffer: Q@G@F counter: @D 
— OA 

number buffer: 6005 counter: @E 
— OA 


negative result (— @@@5) counter unchanged 


When @A is added to the negative number contained in the buffer the 
result will be 5 once more. This will be the number of units contained in 
the decimal answer. Thus, 911g = ZY 514g. 

The contents of the counter (GE) are now transferred to the number 
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buffer and the counter is once more reset. The new buffer contents are 
then worked on to provide the next number: 


number buffer: GG@GE counter: 00 
— OA 

number buffer: $004 counter: @1 
— OA 


negative result (— @@@6) counter unchanged 


When @A is added to the negative number contained in the buffer the 
result will be 4 once more. This will be the number of tens contained in 
the decimal result. Thus, 9146 = Z 457g. 

The counter contains 1, which represents the number of hundreds in the 
decimal result. The complete answer is therefore: 9116 = 14519. The 
methods used to present this figure to the computer's display were de- 
scribed in Book I. 

Now the algorithm for the binary to decimal conversion program is ready 
and the rough flow chart can be drawn up, as shown in figure 2. 

Firstly, the display buffer is cleared. The computer then scans the key- 
board and the display. The subroutine which the main program requires 
was also dealt with in Book I, subroutine GETBYT (start address 1D6F). 
If a command key is depressed, the processor will reset the N-flag 
before returning to the main program. In this way, the display can be 
cleared whenever a command key (it doesn‘t matter which) is depressed. 









clear display (= 606000) 


return from subroutine 
with one data byte 


scan keyboard + 
display 


command 
key 
? 


; no 
data byte > 
INH 
hexadecimal to 
decima! conversion 
decimal value ~ 
POINTH + POINTL. 


Figure 2. The general flow chart required to control the display and scan the 
keyboard during the hexadecimal to decimal conversion. 











data byte > display buffer 


indicate decimal value on 
display after conversion 


80915 -5 -2 
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Once the two data keys have been depressed, the microprocessor returns 
from the GETBYT subroutine with the entered data byte in the accumu- 
lator. This data byte is then transferred to the display buffer INH. It is at 
this point that the binary-to-decimal conversion takes place according to 
the algorithm drawn up previously. The decimal number obtained is also 
transferred to the display buffers POINTH and POINTL. 

Once again, the computer will scan the keyboard and display the hexa- 
decimal and the decimal numbers via the GETBYT subroutine. The full 
details of the flow chart are given in figure 3. The display buffer consists 


FF 19 06 


. 
FA ) 00000 — display 
. 


FF 11 990 


_ fg scan keyboard and dispiay, return with 
7 JSR — GETBYT if wee data byte in the accumulator 


STAZ — INH F9 accumulator - display buffer 
STAZ -- HEXL D7 accumulator > data buffer 


i JSR — HEXDEC ih (2) binary-decimal conversion 
JMP —DA ‘®) 





HEXH = D8 HEXL = D7 Y -register 
POINTH = FB POINTL=FA INH = F3 
80915-5-3a decimal number hexadecimal 


Figure 3a. The detailed version of the flow chart in figure 2. The display buffer INH 
contains the hexadecimal value that is to be converted. After the conversion, the 
decimal number will be stored in display buffers POINTH and POINTL. Memory 
locations HEXH and HEXL and the Y index register act as temporary memory banks. 
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of addresses QOFQ9...@@FB. The data or number buffer occupies ad- 
dresses 9@D7 and @9D8. The memory locations reserved for the program 
can be labelled as follows: 


INH “ $ QOFO 


POINTL * $@@FA_ display buffers 
POINTH * $ @@FB 
HEXL * $@@0D7 


HEXH * $9@@D8 _ data buffers 
GETBYT * $1D6F monitor subroutine 


During the program the Y register will be used as a counter instead of a 
memory location. As can be gathered from figure 3, the main program 
DISPLAY contains the two subroutines GETBYT and HEXDEC. Both are 
different in that the start address of GETBYT is known, whereas that of 
HEXDEC is not. This is no problem, as from now on the computer will be 
able to calculate start addresses by itself. Thus, there is no need to assign a 
Start address to HEXDEC. In addition, the main program includes a jump 
and a branch instruction. The destination address for the jump instruction 
and the displacement value for the branch instruction are also calculated 
by the computer, so that there is no need for the programmer to worry 
about them either. 

The subroutine HEXDEC, which is the practical version of the algorithm 
we developed before, incorporates two subroutines, COMMUN and 
SUBTRA, as well as jump and branch instructions. Here again, we needn't 
worry about which addresses belong to which subroutines and what 
displacement values are required for the branch instructions. These tire- 
some, time-consuming calculations can all be left to the computer to deal 
with, which, after all, cannot go wrong! 

The section of the monitor program which calculates the displacements of 
branch instructions is called the assembler. It is started in the usual manner, 
at address 1F51, by depressing the GO key. 

For the assembler to function properly, the computer requires a tool to 
prepare the programs so that the assembler can ‘digest’ them. This too! is 
in fact the editor. 

As we mentioned before, the computer calculates addresses and displace- 
ments by itself. The question is: how does it know where to jump or 
branch, if the programmer does not enter the start or destination ad- 
dresses? Well, the programmer simply enters symbolic addresses into the 
computer. From now on it is enough to enter JSR-SUBTRA, instead of 
JSR-G23B, for they both mean the same thing as far as the JC is concerned! 
Thus, the assembler’s task consists of allocating the absolute address 023B 
to the symbolic address SUBT RA. However, the word SUBTRA cannot be 
entered into the JC, as the only means of entering data is the hexadecima! 
keyboard — there is no alphanumeric one at the present time. This means 
that a label may only consist of hexadecimal characters which could, if we 
are not careful, be interpreted as op-codes or operands. The computer 
must therefore be able to distinguish between op-codes and labels. What in 
fact is the difference between them? To find out, look at the appendix to 
Book | where the op-codes of the 6502 microprocessor have been com- 
piled in hexadecimal sequence. As the table shows, not all the hexadecimal 


14 


FF 1200 





i JSR — COMNUM i: 






calculate the units 


85 FA store units in the display buffer 


STAZ —POINTL 
STYZ — HEXL D7 counter contents to data buffer 


JSR — COMNUM calculate the tens 


LDX #64 


B4 


2¢ 


FF 1300 













GA ASL -A 
a 
Dg 


< 


shift the contents of the counter 


four places to the left 


G3) shifted four times? 






95 ORAZ — POINTL FA store units and tens in 


STAZ — POINTL 
STYZ — POiNTH 


85 FA the display buffer 


84 FB hundreds to display buffer 






60 return 80915-5-3b 
Cc 
FF 14 @ 

AQ LDY #@0 reset counter 

84 STYZ —HEXH DS reset high order data byte 

20 i JSR —SUBTRA a (15) subtract GA until result is negative 

AS LDAZ —- HEX D7? 

69 ADC GA correct with GA 

60 FerUrn 80915-5-3c 


Figures 3b and 3c. The actual hexadecimal to decimal conversion takes place in the 
course of the HEXDEC subroutine. The COMNUM routine first calculates the units, 
then the tens and finally the hundreds. 
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FF 15 60 







SUBTRA 


LDAZ —- HEXL 


> 


JMP — SUBTRA 


set carry 


07 


subtract GA until result is negative 





D7 






D8 














FF 16 6¢ 


80915-5-3d 





return 


Figure 3d. During the subroutine SUBTRA the processor carries out a 16 bit sub- 
traction. The hexadecimal number QA is subtracted several times until it gives a 
negative result. Here the Y index register acts as a subtraction counter. 


numbers from @@...FF have been allocated op-codes. There are several 
gaps. Even the hexadecimal number FF has no op-code. Let us give it a 
pseudo op-code, in other words, an op-code unknown to the micropro- 
cessor. Now the hexadecimal number FF can be used as a label. We could 
have chosen any other unused number from the table, such as 04, D3 or 
F7, but FF happens to be the easiest to enter. 

The label SUBTRA still has a few other aspects worth considering. 
SUBT RA is the program departure point, or to be more exact, the symbolic 
start address of a subroutine. The pass-word to call up the subroutine is 
JSR-SUBTRA (jump to subroutine SUBTRA). Since only hexadecimal 
figures are used in the editor, subroutine SUBTRA will have to have a 
number. This can be any number from @@... FF. Up to 256 such labels 
can be used for identification purposes in a program. 

It is now high time to put the above into practice with the aid of a few 
examples, for from now on program entry will always involve the editor 
and the assembler contained in the monitor program. 
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BEGADH BEGADL 





@2¢5 


ENDADH ENDADL | 


OGES GGE4 


80915-5-4 


Figure 4, This is how the editor stores the initial instructions pertaining to the 
DISPLAY program (figure 3a} in the Junior Computer’s memory. BEGAD and 
ENDAD are pointers and define the work space. 


The Editor 
1. Structure of a label: 
FF | 15 G0 example 
FF XX G0 general pattern 
label indicator label number label limiter 


As can be seen a label is three bytes Jong. In order to enter a label into the 
JC, six keys will have to be depressed. Figure 3 shows that the label 
SUBTRA is replaced by FF 15 @@. Once the editor has been activated, 
labels like this can be entered straight into the computer. An ASCII 
keyboard (typewriter) will not be necessary. 


Other va/id entries include: 

keyboard = display 

FF 37 00 FF 37 @0 label number 37 
FF FA@QG FFFAGQ@ label number FA 
FF @6 06 FF QO 00 label number G¢ 
Non-valid \abel entries include: 
keyboard display 


FF 21 FF 21 XX _ limiter missing 
FF 56 FF FF 56 FF wrong limiter 
FF FF 41Q@ although the correct limiter will appear in the 


display after the label entry, it must be over- 
written with 00. 
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Once the entire label entry has been completed, the display buffer is 
copied into the memory. 


2. Structure of a JSR instruction: 


20 14 00 example 
20 XX 00 general pattern 
op-code of JSR subroutine number limiter 


As usual, the jump to subroutine instruction is three bytes long. Now let 
us return to figure 3. During the HEXDEC subroutine, COMNUM is called 
twice. Usually, the instruction would be written as JSR-COMNUM. Subrou- 
tine COMNUM has been given the label number 14, but any other number 
would have been equally suitable. To the computer, 20 14 @@ means: jump 
to subroutine number 14, or to put it more precisely: jump to the subrou- 
tine which starts with the label number 14. As you will remember, 
FF 14 @6 and COMNUM are the same in the flow chart. 

Other valid entries for a JSR instruction include: 

keyboard display 

2039 G0 2039 G6 jump to subroutine 39 

209A 06 209AGQG_ jump to subroutine 9A 

20 20 60 2020 G0 jump to subroutine 20 

Non-valid JSR entries include: 

Keyboard display 


20 11 2011 XX _ limiter missing 
20719F 20719F wrong limiter 
20 202800 although the required subroutine number and the 


correct limiter appear in the display, this is a 
coincidence and the entire instruction must be 
entered. Only then will the display buffer be 
copied into the memory of the computer. 


3. Structure of a jump instruction: 


4C 11 AG example 
4C XX 00 general pattern 
op-code of JMP instruction label number limiter 


The jump instruction is also three bytes long. Towards the end of the main 

routine DISPLAY, a jump instruction can be seen, JMP-DA, or jump to 

label DA. The JC interprets 4C 11 @@ as: jump to label number 11. Again, 

labels DA and FF 11 @@ are the same. 

Other valid entries for a jump instruction include: 

keyboard display 

4C 7700 4C776@ jump to label number 77 

4C 2900 4C2990@ jump to label number 29 

4C 0000 4C9000 jump to label number 0¢ 

Non-valid jump entries include: 

Keyboard display 

AC 32 4C 32 XX _ limiter missing 

4C 08 AA 4C@8 AA wrong limiter 

4C 4C 240@ again, the complete instruction must be entered 
before the computer will copy it into the memory 

The hexadecimal numbers following the JSR and JMP instructions do not 

therefore constitute absolute addresses, but label numbers which the 
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programmer is free to select. The true absolute addresses to be jumped to 
are calculated by the computer during assembly. The JSR and JMP instruc- 
tions are three bytes long and require the limiter byte 0@. This fact must 
be taken into account during program entry. 

4. Structure of a branch instruction: 

The 6502 microprocessor features eight branch instructions: BCC, BCS, 
BEQ, BMI, BNE, BPL, BVC and BVS with the op-codes 99, B@, F@, 30, 
D@, 10, 50 and 7@ respectively. The displacement values for these instruc- 
tions are calculated by the assembler in the monitor program. A branch 
instruction entry has the following structure: 

30 16 example 
30 XX general pattern 


op-code of BMI instruction label number 

Other examples of branch instruction entries are: 

9034 BCC to label number 34 

B@ F6 BCS to label number F6 

F@ 19 BEO to label number 19 

3056 BMI to label number 56 

D@9D_ BNE to label number 9D 

1@21 BPL to label number 21 

50 A3 BVC to label number A3 

7@EA_ BVS to label number EA 

Thus, the numbers following the branch instructions are not displacements, 
but label numbers which the programmer can select at will. The true 
displacements are calculated by the JC during essembly. Branch instruc- 
tions are two bytes long and so do not require the timiter byte Q@. 

5. Further points to consider: 

During program entry in the editor mode care should be taken to define 
label numbers unambiguously. This means that a certain label number may 
only be used once. The label numbers may be entered in any sequence. 
Where the entry of branch instructions is concerned, it is important to 
make sure that the range (-128...+127) is not exceeded, for if this 
happens, the assembler will not report the error, but will calculate the 
wrong displacement. 

6. JMP, JSR and their defined addresses: 

In many cases, a JMP or JSR instruction will lead to a definite address. 
In other words, the computer is not supposed to assembie the instruction. 
In figure 3 the computer is shown to jump from the main program to the 
subroutine GETBYT at address 1D6F. This address is established by the 
monitor program and may not change during assembly! To prevent such 
instructions from being assembled, a safeguard has been built into the 
assembler. 


“A JMP or JSR instruction will only be assembled if a label number is 
attached to it. 
“A JMP or JSR instruction will not be assembled if its abel number is 
ambigiuous (already in use). 
Example: JSR-GETBYT = 20 6F 1D 
op-code of JSR ADL ADH 


The low-order address byte (ADL) belonging to the JSR instruction is 
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6F. The label number 6F does not appear in the program (figure 3) and sO 
the assembler will not assign an address to the JSR-GETBYT instruction 
but will ignore it. 


7. Entry of the remaining instructions: 
Taking the load instruction (LDA) as an example: 


keyboard display mnemonic address mode 

AQT7F AQ 7F LDA 7F immediate 
AD821A AD 821A LDA-1A82 — absolute 

A5E6 A5 E6 LDAZ-E6 zero page 

A1FA A1 FA LDA-(FA,X) pre-indexed indirect 
BI1FA B1FA LDA-{FA},Y post-indexed indirect 
BD@90G2 BD 0642 LDA-G200,X absolute indexed, X 
B9D122 B9D122 LDA-22D1,Y absolute indexed, Y 


B53 1 B5 31 LDAZ-31,X zero page indexed,X 

The validity of the above also holds for the remainder of the 6502 instruc- 
tions. The computer will calculate the length of each instruction by itself. 
For this it will use the monitor subroutine OPLEN which is almost ident- 
ical to LENACC described in Book |. it enables the computer to control 
the display irrespective of the instruction length. As you know, instruc- 
tions that use implied addressing are only one byte long. For this reason 
only the op-code field of the display will be lit when these instructions are 
entered. The rest of the display will be ‘blanked’. 

Instructions belonging to the above category have no symbolic addresses 
allocated to them. That is to say, the programmer must define the address 
locations from which data is to be read out or to which data is to be 
written, before the program can be entered. 


8. Definition of program memory space: 

Before the editor can be activated, the memory space required for 
_ storing the program must be defined. The boundaries are determined by 
two address pointers located on page zero. The pointer BEGADH, 
BEGADL (= BEGin ADdress High, BEGin ADdress Low) is stored in 
locations: 
BEGADL * $ @@E2 
BEGADH* $ @@E3 
The pointer ENDADH, ENDADL (= END ADdress High, END ADdress 
Low) is stored in locations: 
ENDADL* $ 69 E4 
ENDADH™ $ @@E5 
BEGAD therefore always refers to the initial address and ENDAD to the 
final address of the memory area in which the program is to be stored. 
Two consecutive pages of memory, page 2 and page 3, are available in the 
standard version of the Junior Computer. This amounts to 512 bytes, 
which should be ample for most programs. It is therefore a good idea to 
define this large area of memory space by means of the address pointers 
before entering a program: 
BEGADH, BEGADL = §@2 00 and 
ENDADH, ENDADL = @3 FF 
The relevant data can be entered into these pointers via the keyboard as 
follows: 
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AD@OG@E2 | 

DA OG ADL of the BEGAD pointer 
+ @2 ADH of the BEGAD pointer 
+ FF ADL of the ENDAD pointer 


+ 93 ADH of the ENDAD pointer 

The pointers are located on page zero and the memory area in which the 
program is to be run can be defined as 9200...@3FF. Other areas of 
memory can also be ‘fenced off’ in the same manner. 

Page@ $ G000...00E0 

Page 1 $ 0100 ...@01F2 

Page 1A $ 1AQ@...1A79 

There is only a limited amount of memory space available on these pages 
as they are partly occupied by the monitor program and the stack. If the 
limits of these areas are exceeded, the JC will report this as an error: 
FEEEEE. 

9. How to start the editor: 

Once the required memory space has been defined, the editor can be 
put into operation. The start address is 1CB5 and it can be initiated by 
depressing the following keys: 

AD1CB5 

GO 

The op-code portion of the display will now show 77 and the operand area 
of the display will remain blank. This is the computer’s way of telling you 
that the editor is functioning and is ready to store any instructions entered 
inside the pre-determined operational memory area (work space). 

10. Editor command keys: 

As soon as the editor is activated, the functions DA, AD, +, PC and GO are 
no longer valid. From now on, the second heading associated with these 
keys (SEARCH, INPUT, INSERT, DELETE and SKIP) will become 
effective. These keys enable instructions to be entered into the computer 
(INSERT, INPUT), to be deleted (DELETE) or even to be searched for 
(SEARCH). In addition, it is possible to jump from instruction to in- 
struction via the SKIP command. Let us now examine each command in 


turn. 
INSERT 


The INSERT command allows a new instruction to be inserted before the 
one indicated on the display. 

Whenever the pseudo-instruction 77 appears on the display the INSERT 
key must be depressed without fail for the data to be entered as instruc- 
tions. The INSERT key is therefore the first key to depress if a label or an 
instruction is to be entered into the computer, once the editor has been 
activated. 


INPUT. 


The INPUT command enables a new instruction to be entered after ae 
one indicated on the display. 

The programmer can select between the INPUT and INSERT commands at 
all times. Whichever key was the last to be operated will then be valid. As 
far as both are concerned, it should be noted that when they are used to 
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enter labels or instructions, the following data will be shifted into the 
display buffer one byte at a time. Only when the entire instruction has 
been entered into the computer will it be copied from the display buffer 
into the pre-determined memory area. This means that if an error occurs 
when entering an instruction, either the INSERT key of the INPUT key 
must be depressed several times before the error can be corrected. INSERT 
will place the fresh instruction in front of the one previously displayed, 
whereas INPUT will place it behind that instruction. Thus, each key will 
retain its proper function. The result is a simple, yet highly effective pro- 
cedure to enter and edit programs. 


The DELETE command enables the displayed instruction to be erased 
from memory. 

The computer will fill up the memory locations which have now become 
available. This is done by transferring (shifting) the data block immedi- 
ately following the erased instruction upwards by the number of bytes 
deleted. It ensures that no ‘gaps’ occur in the program once an instruction 
is deleted. In other words, the instruction following the one just deleted 
will appear on the display as soon as the DELETE key is pressed. Again, 
by repeatedly depressing the INSERT or INPUT keys, new instructions 
can be entered before or after the instruction shown. 


The SEARCH command enables the computer to look for {and find) any 
double-byte pattern in the memory area. 

If, for example, we depress the keys SEARCH FF 11, the computer will 
search for fabel number 11 and show it in the display. The SEARCH 
command also manipulates the display pointer CURAD, also located on 
page zero, which always points to the op-code currently on display. This 
pointer is held in the following memory locations: 

CURADL* $ G@EG6 

CURADH* $ @@ E7 

Initially, the SEARCH command leads the display pointer CURAD to the 
Start address of the previously defined memory area. Since each instruc- 
tion has a certain, specific length, calculated by the computer, CURAD is 
moved from op-code to op-code {and not from memory location to 
memory location). Through a set of simple comparisons, the computer can 
establish whether or not the required bit-pattern has been found. Labels 
are not the only things that can be searched for in this manner, any other 
type of instruction can also be located; for example: 

SEARCH AS @@, 

SEARCH 4C 11 (figure 3) or 

SEARCH 69 @A (figure 3). 

Note that if the same instruction occurs more than once in a program, the 
SEARCH command will only locate the first of them (the instruction 
nearest the start of the memory area). !n other words, it is unable to 
discover two identical instructions in a row! 
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The SKIP command enables the computer to jump from instruction to 
instruction. 
This command is used to run through a program step by step, so that it 
can be checked for any errors in a matter of seconds. 
Note: The INPUT command is essentially a combination of the SKIP and 
INSERT commands. This creates the following analogies: 
SKIP INSERT X X = INPUT X X (1 byte) 
SKIP INSERT X X X X =INPUT X XXX (2 bytes) 
SKIP INSERT X X X X X X = INPUT X X X X X X _(3 bytes) 
11. Cold start entry/Warm start entry: 

There are two start addresses for the editor: 
Cold startentry = 1CB5 and 
Warm start entry = 1CCA. 
If the editor is started at the former address, it will add (and initialise) a 
few pointers to page zero outside the memory area chosen by the pro- 
grammer. Thus, before a program can be entered for the first time, the 
editor must be started at address 1CB5. 
Warm start entry,on the other hand, makes it possible for the programmer, 
to return to the editor after depressing the RST key. In this case, the 
pointers on page zero will not be initialised. After starting the editor at 
address 1CCA, the command keys INSERT, INPUT, DELETE, SEARCH 
and SKIP will operate in their usual manner. 
12. How to enter the program shown in figure 3: 


press key: display: comments: 

RST XK XX XX 

AD @@E2 0@ E2 xXx initialisation 

DA 0 00 E2 6G set the BEGAD pointer 

+ @ 2 00 E3 02 

+ FF 00 E4 FF set the ENDAD pointer 

+ 63 00 E5 03 

AD 1CB5 1C B5 26 

GO 77 start the editor (Cold start entry) 

INSERT FF100@ FF 10 00 enter fabel number 10 (DISPLAY) 

INPUT A9@@ AQ 00 LDA #00 

INPUT 85 F9 85 F9 STAZ-INH 

INPUT 85FA 85 FA STAZ-POINTL 

INPUT 85 FB 85 FB STAZ-POINTH 

INPUT FF410@ FF 11 00 label number 11 (DA) 

INPUT 206F1D 20 6F 1D JSR-GETBYT (6F is not a label number!) 

INPUT 161406 10 10 BPL to label number 10 

INPUT 85€E 85 XX error! Instruction is still to be entered 
into memory 

INPUT 85 F9 85 F9 ST AZ-INH 

INPUT 8507 85 D7 STAZ-HEXL 

INPUT 290129086 26 12 G0 JSR-HE X DEC (label number 12 is HEXDEC) 

INPUT 4C11090 4C 11 06 JMP-DA (label number 11 is DA) 

INPUT FF120@6 FF 12 @@ label number 12 (HEXDEC) 

t{NSERT error! INSERT instead of INPUT 
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INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 


201466 
SOFA 
84D7 
2014620 
A2@4 
FF13@ 
OA C 
CA 
D@13 
@5FA 
85FA 
84FB 
6 0 


0 
A 


SEARCH FF 13 


SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 
SKIP 


INSERT FF1400 


INPUT 


84D8 


20 
85 
84 
20 
A2 
FF 
GA 
CA 
DO 
05 
85 
84 
60 
FF 
QA 
CA 
DG 
@5 
85 
84 
60 
77 
FF 
84 


14 66 
FA 
D7 
14 00 
04 
13 60 


EEEEEE 


13 

FA 
FA 
FB 


13 60 


13 

FA 
FA 
FB 


14 00 
D8 


JSR-COMNUM (label number 14 is COMNUM) 
STAZ-POINTL 

STYZ-HEXL 

JSR-COMNUM (label number 14 is COMNUM) 
LDX # 04 

label number 13 (HD) 

press command key, otherwise error! ASL-A 
DEX 

BNE to label number 13 

ORAZ-POINTL 

STAZ-POINTL 

STYZ-POINTH 

RTS 

search for label number 13 


77 means: depress the INSERT key!!!! 
label number 14 (COMNUM) 
STYZ-HE XH 


Note: The instruction LDY #@@ was inadvertently forgotten. It can be 
Inserted quite easily with the aid of the INSERT command. Thus: 


INSERT AQQ®@ 


SKIP 


AG 00 


84 D8 


LDY #60 
STYZ-HEXH 


The instruction LDY #@@ has now been inserted in front of STYZ-HEXH. 
This involved a fair amount of work for the computer, while the pro- 
grammer could sit back and watch. Now the INPUT command will enable 
us to continue, for a new instruction is to be entered after 84 D8. Thus: 


INPUT 29015060 20 15 G0 JSR-SUBTRA (label number 15 is SUBTRA) 
INPUT 18 18 CLC 

INPUF A5D7 A5 D7 LDAZ-HEXL 

INPUT 69QA 69 @A ADC #@A 

INPUT 694 60 RTS 

INPUT FF15@@ FF 15 @@ label number 15 (SUBTRA) 

INPUT 38 38 SEC 

INPUT A5D7 A5 D7 LDAZHEXL 

INPUT ESQ@Q@A EQS @A SBC #@0A 

INPUT 850D?7 85 D7 STAZ-HEXL 

INPUT A5D8 A5 DS LDAZ-HEXH 

INPUT E9O@ EQ 00 SBC # 00 

INPUT 3616 30 16 BMI to tabel number 16 

INPUT C8 C8 INY 

INPUT 4C15690 4C 15 00 JMP-SUBTRA (label number 15 is SUBT RA) 
INPUT FF16@090 FF 16 60 label number 16 (SUB) 

INPUT 64 60 RTS 
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The complete program has now been entered into the Junior Computer. It 
is advisable to check that everything has been entered correctly. This can 
be done as follows: 

SEARCH FF19@ 

SKIP 

SKIP 


SKIP 


Only when the entered program corresponds to the flow chart can the 
assembler be started. 


The Assembler 


We have now entered a program into the computer with the aid of the 

editor, a program containing symbolic addresses. These consist of label 

numbers, subroutine numbers or labels to which the computer is to jump 

or branch. Such a program is not able to run on JC, as in its present form 

the microprocessor is unable to interpret the instructions. It is up to the 

assembler to ‘shape’ the program in such a way that the microprocessor 

can understand it. The assembler’s task consists of: 

* removing all the labels from the program 

* assigning the true absolute addresses to the JSR instructions so that they 
are Unambiguous 

“ treating the jump instructions likewise 

* calculating the correct displacement values for branch instructions 

* enabling the program to be stored in the programmable memory, after 
assembly, in an acceptable form for the 6502 microprocessor. 


How is the program stored in memory before assembly? 


The start address of the program was chosen to be 02@@. Figure 4 shows 
how the editor stored the program in the computer’s memory. Since three 
memory locations were reserved for each label, this program is consider- 
ably longer than the assembled version will be. The start address of the 
assembler is 1F51: 


RST call the monitor program 
AD1F51 enter start address 
GO start the assembler 


After the GO key is depressed, the display will be blanked for a fraction of 
a second... all that is needed for the computer to assemble the program. 
lf the program was much longer, the display may remain blank for several 
seconds. As soon as the program has been assembled, the computer will 
return to the monitor program. The keys AD, DA, +, PC and GO will now 
be valid once more. 


How is the program stored in memory after assembly? 


The Junior Computer features a Two Pass Assembler. This means that the 
program is not assembled in one go, but in two stages, or ‘passes’. 
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label number 1¢ 


labet number 11 


; JSR - 1D6F (monitor routine) 


BPL to label number 10 





'> BPL to label number 16 


JSR - tabel number 12 


label number 12 


JSR - label number 14 


} JMP - label number 11 


80915-5-5 





Figure 5. The addressable work space starts at BEGAD and ends at ENDAD. The 
memory space between the two pointers contains the program starting in this 
particular example from label FF 16 90 and ending with the EOF character 77. This 
is called a file. It contains all the instructions that are used in the program, together 
with their addresses and labels which have the symbolic op-code FF. The Junior 
Computer cannot ‘digest’ the program in this form, as both the absolute addresses for 
jump instructions and the displacements for branch instructions are as yet unknown. 
The 6502 CPU will not be able to handle the edited data until the program has been 
assembled. 
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Pass one 


The computer reads the entered program. At this stage it is only interested 
in the labels written by the programmer and so will ignore all other instruc- 
tions. If a label is encountered (featuring the characters FF), the label 
number and its address will be stored in a symbol stack. The fatter acts 
simply as a look-up table and is prepared by the computer without any 
help from the programmer. 

Once the label number and its address have been ‘saved’ in the symbol 
stack, the computer will delete the label from the program. This is done by 
shifting the entire program up by three bytes — the length of the label. 
The label is overwritten by the instruction(s) immediately following and 
therefore disappears from the program. The same procedure is repeated 
until the processor has worked through the whole program from start to 
finish. 

In the example used, the start address was 0200, so the computer will start 
here. The search continues until another label is found. This will then be 
added to the symbol stack like its predecessor, along with its address. 
Eventually, all the labels will have been removed from the program. 
Everything the computer needs to know about the labels is now being 
stored inside the symbol stack. This is a 256 byte software register capable 
of storing up to a maximum of 256/3 = 85 labels. This should be more 
than enough room to assemble programs in sections. 


Pass two 


Now the assembler will run through the entire program once more, starting 
at address 9200. As all the labels have already been deleted, the assembler 
will concentrate on the following instructions only: 

* JMP- 

* JSR- 

* branch instructions such as BPL, BMI, BEQ etc. 

_ These instructions are as yet succeeded by label numbers. When the JC 
encounters one of the jump instructions, it will look to see which label 
number follows. Every label number has its own absolute address, which 
the computer can fetch from the symbol stack. How does it find the 
correct address in the symbol stack? During the first stage of assembly, 
remember, the computer saved the label number and its absolute address 
in the stack. Now the computer will compare the jabel number behind the 
jump instruction being assembled with those in the symbol stack. The 
corresponding absolute address is then inserted after the instruction 
thereby overwriting the label number and the limiter. The whole pro- 
cedure is repeated until all the JMP and JSR instructions have been as- 
sembied. 

This leaves the displacement values for the branch instructions. The next 
step for the computer, therefore, is to trace all the branch instructions 
contained in the program. These are still followed by the label numbers to 
which the branch is supposed to lead. Since the computer knows the 
address of each branch instruction and since the destination address is 
stored in the symbol stack, the displacement value can be calculated 


27 


< label deleted 









62 G0. 


labet deleted, 
JSR instruction 
was not assembled 


BPL instruction was assembled, the 
calculated displacement is F3 


JSR instruction was assembled, 
the absolute address was calculated 
to be 6217 


JMP instruction was assembled, 
the absoluta address was calculated 
to be 6248 


SA instruction was assembled, 
the absolute address was calculated 
to be @22E 






BMI instruction was assembled, 
the catculated displacament is 94 


JMP instruction was assembled, 
the absolute address was calculated 
to be @23B 


~~ 
wt 


77 is the EOF character 
(EOF = End Of File = End of program) 


D 


During assembly the program was shifted up from below. This 
caused the symbolic addresses and the jabel numbers to be 80915-5-6 
dekted. 


Figure 6. After assembly, all the labels have disappeared from the file, which is why 
the program looks shorter. The instruction op-codes are now followed by their 
corresponding absolute addresses. Similarly, displacements have been assigned to the 
branch instructions. Now the program is acceptable to the 6502 CPU. 
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without any difficulty: 
destination — source + 2 = displacement, 
which can be translated as: the address location to be branched to, minus 
the address location where the branch instruction is situated, plus two 
equals the displacement value. The program given in figure 3 is shown in 
its assembled form in figure 5. 
We have now covered the operation of the assembler. It should be added 
that the editor can also be used to run through an assembled program. The 
following should then be taken into account: 
* the editor should on/y be started by way of a warm start entry (address 
1CCA) 
“ the pointers on page zero must be set manually: 
BEGAD = CURAD 
ENDAD = CEND (CEND = current end address) 
Based on the example given in figure 3, the following keys are to be 
depressed for the editor to be used on an already assembled program. 
AD @@OE6 


DAQOG set CURAD pointer to $200 
+ @Q2 | 

+ FF set CEND pointer to @3FF 
+ 93 

ADICCA warm start entry 

GO start the editor 


This procedure enables the SKIP key to be used to run through an as- 
sembled program. The SEARCH command gives the programmer the 
additional possibility to search for certain instructions inside the 
assembled program. The INSERT, INPUT and DELETE keys should only 
be used when entry or deletion of instructions will leave any jump or 
branch instruction absolute addresses and length — as calculated by the 
computer — unimpaired. 


Important addresses for the editor and assembler: 


1. Editor 
Cold start entry : $1CB5 
Warm start entry : $1CCA 
Pointers belonging to the editor: 
BEGADL* $ ea begin address pointer 
BEGADH * $ @G@E3 
ENDADL* $ aad end address pointer 
ENDADH * : QGE5 
CURADL * > agEe) current address pointer 
CURADH * $ @GE7 
CENDL * $ poet 
CENDH * $ @QE9 
2. Assembler: 
Start address: $ 1F51 
3. Further possibilities for the editor and assembler: 
The ST key on the computer's keyboard is linked to the NMI circuit. 
The NMI-vector can be programmed so that either the editor or the 


current end address pointer 
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assembler can be started by depressing the ST key. The NMI-vector is 
stored in address locations: 

NMIL * $1A7A_ low-order address byte 

NM!IH * $1A7B_ high-order address byte 

By loading the start addresses into these locations the programmer can call 
up either the editor or the assembler with the ST key: 

AD 1A7A _ cold start entry via ST key 

DAB5 

t LG 

or 

AD 1A7A_ warm start entry via ST key 

DACA 

eG 

or 

AD 1A7A _ start the assembler via ST key 

DA 5 1 

+ Ae 

We have now reached the point where we are able to operate the editor 
and assembler contained in the monitor program. These special features 
make it possible to enter and alter programs quickly and efficiently. This 
saves the programmer a lot of work — which is what computers are 
designed for! The editor and the assembler enable programs to be stored in 
memory in one ‘lump’, without gaps. This is very important when only a 
limited amount of memory space is available. 
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6 


The Peripheral Interface 
Adapter or PIA 


The Junior Computer possesses a peripheral interface adapter 
which, like the CPU, is contained in a 40-pin IC. This multi- 
function device, called PIA for short, takes care of the entire 
data exchange between the outside world and the Junior 
Computer. The outside world can assume various forms: it can 
be a hexadecimal keyboard, a seven-segment display, an ASCII 
keyboard (simular to that of a typewriter), a printer or even a 
servo from a model aircraft. This chapter will describe the way 
in which the computer controls peripheral devices connected 
to it, how it receives and transmits data via the PIA and how 
this data is processed. 


A computer without any inputs or outputs would be a virtually useless 
machine, for then it would be unable to communicate with the operator, 
who plays an essential part in the execution of a program. The situation 
would be rather like that of a university professor who, having reached 
a high level in scientific research, is unable to impart any knowledge to his 
students due to a total lack of vocabulary. Similarly, if a computer did not 
react to the inaptitude and inconsistency of the (human) programmer, the 
latter would never learn how to operate the computer correctly. 

How can a computer communicate its ‘thoughts’ to the outside world? 
The data exchange that takes place between the operator and the com- 
puter is just like a conversation between two people. To be able to pass 
on thoughts and ideas stored in his brain, man uses language. The computer 
also has thoughts and ideas, stored in the memory in the form of processed 
data. When such data is to be imparted to the outside world the computer 
makes use of a printer or, as in the case of the Junior Computer, a six digit 
(alpha) numeric display. 

To be able to follow a conversation it is just as important to listen as it 
is to talk, for this is the only way to receive information from the person 
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you are talking to and in fact the only way to find out whether you are 
“getting through” to him. The computer “listens” by means of a keyboard 
on which the incoming data is typed. In large(r) computers this will be an 
ASCII keyboard, but the basic Junior Computer is quite content with a 
hexadecimal version. 

Just as a person uses his mouth to speak and his ears to listen, the Junior 
Computer transmits and receives information via the PIA. Therefore, the 
PIA must have suitable inputs and outputs to receive and transmit data, 
respectively. The term ‘‘data” refers to electrical signals which are either 
logic @ or logic 1, and which change from one level to the other. The PIA 
in the Junior Computer is a 6532 type. This LSI! (large scala integration) 
device contains 128 memory locations, a timer which can be programmed 
in a number of ways, a flag register and an edge detector that can respond 
to either positive or negative going pulses. 

The PIA can be thought of as being a micro-microprocessor which can be 
programmed to carry out various instructions by means of 19 special 
‘registers’. Their operation and the numerous ways in which they can be 
orogrammed will be fully explained in the course of this chapter. 

An overall summary of the 19 registers is given in the following table: 


1. PORT A and PORT B 
— PAD: PORT A Data Register 
— PADD:PORT A Data Direction Register 
— PBD: PORT B Data Register 
— PBDD: PORT B Data Direction Register 
2. Timer start; interrupt request is disabled 
— CNTA: CLK1T (division factor = 1) 
— CNTB:CLK8T (division factor = 8) 
— CNTC: CLK64T (division factor = 64) 
— CNTD: CLK1KT (division factor = 1024) 
3. The flag register and timer 
— RDFLAG read the flag register 
— RDTEN read timer and enable IRQ 
- — RDTDIS read timer and disable IRO 
4. Timer start; interrupt request is enabled 
— CNTE:CLK1T (division factor = 1) 
— CNTF:CLK8T (division factor = 8) 
— CNTG: CLK64T (division factor = 64) 
— CNTH: CLK1KT (division factor = 1024) 
5. PA7 as the edge detector 
— EDETA:sensitive to negative edge, PA7-IRQ disabled 
— EDETB: sensitive to positive edge, PA7-IRQ disabled 
— EDETC: sensitive to negative edge, PA7-IRQ enabled 
— EDETD:sensitive to positive edge, PA7-!RO enabled 
Each register will be dealt with in turn. 


PORT A and PORT B 


The 6532 contains two ports: PORT A and PORT B. Together they 
provide the input and output connections for the peripheral interface 
adapter. Each of the sixteen lines can be individually programmed as an 
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input or an output. The operator can connect various forms of peripheral 
equipment to any of the input/output lines. In the Junior Computer each 
of the sixteen lines is fed to a multi-way connector, or port connector. 
Figure 1 shows that the hexadecimal keyboard and display are also con- 
nected to the PIA, so that the operator does not have the full 16 lines at 
his/her disposal. The lines that can be used are PA7, PB@ and PBS... PB/. 
If the keyboard and display were made redundant, however, all the port 
lines would be available. 


address bus 


data bus 


f control bus 


, a9 sas gis] giz 
Cc 
ale $3 alsin SI a5) 


eSeamew ae” SEeee8 8a az inig 
aaaaqeaales Sonnaob00 w 2S \3i2 





fh 15 PEt 
pps P82 | 
row select cps Psa | 
D 12 PB4 


Pee 23 
Gi > PBI 24 
Paz 25 


PORT CONNECTOR 31 PINS 


80915-6-1 = 5 
keyboard display 


Figure 1. The hexadecimal keyboard and display are connected to the input/output 
ports of the PIA. The remaining port lines, PA7, PB@ and PBS .. . PB7 can be used 
for the operator’s programs. 
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The internal structure of the PIA 


A similar diagram to that shown in figure 1b (Book 1, chapter 3) for the 

microprocessor may be drawn for the PIA. It is given in figure 2. 

The PIA is connected to the microprocessor by means of three buses: the 

data bus, the address bus and the control bus. Thus, it is connected to the 

CPU just like any other “normal” memory device. The three buses operate 

as follows: 

— The address bus selects internal memory locations. 

— The data bus allows bi-directional data transfer between the CPU and 
the PIA. The direction of data transfer is controlled by the R/W line 
connected to the processor. 

— The CPU transmits the following signals to the PIA by way of the 
control bus: 

* the R/W signal 

* the ®2 clock signal 

* the CS2 signal 

" and the RES (reset) signal 

The IRQ line of the PIA is also connected to the CPU by means of the 

control bus. The PIA can therefore request an interrupt. How this is put 

into effect will be discussed later. 

This covers all the connections between the PIA and the microprocessor. 

It is now time to take a closer look at the ‘internal organs’ of the PIA. 

When discussing the PIA, hardware and software are equally important. 

The operator sees the PIA as: 


— Hardware: sixteen lines which can be independently programmed as 

inputs or outputs. They are divided into two sections: port A and 
port B. Both ports consist of eight lines each, that is to say, they are 
8 bits wide. The port lines are called PA@ ... PA7 and PB@.. . PB7. 
The data bus is connected to the individual port lines and, as there are 
two ports, it can be switched either to port A or to port B. Since the 
data bus is bi-directional, the CPU may write onto the port lines, or 
read data from them. When the microprocessor writes a certain bit 
pattern onto port lines which have been programmed as outputs, this 
pattern will remain stored on the output port fines, even after the write 
Operation has ceased (latch function of an output port line). 
When the microprocessor reads one or more port lines which have been 
programmed as inputs, the logic level present at that instant will be read 
(there is no latch function for an input port line). 

— Software: four registers for storing or retrieving data. They are: 

PAD =PORT A Data register 

PADD = PORT A Data Direction register 

PBD =PORT B Data register 

PBDD = PORT B Data Direction register 

As can be seen, each port is made up of two registers: 

1. a data register 

2. a data direction register 

The data direction register controls the direction of data transfer for 
each individual port line. As this register is 8 bits wide, the CPU can 
write a word into the data direction register by means of the data bus. 
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PAD = Port A Data Register 
PADD = Port A Data Direction Register 
PBD- = Port B Data Register 
PBDD = Port B Data Direction Register 


Figure 2. The internal view of the peripheral interface adapter (PLA). It contains two 
ports, each with eight input/output lines. The contents of the data direction registers 
determine whether a particular port line is to be used as an input or as an output. The 
PIA is connected to the CPU by means of the address bus, the data bus and the 
control bus. 


This word wil! be a bit pattern of ‘‘noughts” and “ones” and will have 
the following effect on the port lines: 
— a nought in any position in the data direction register will program 
the corresponding port line to be an input. 
— a one in any position in the data direction register will program the 
corresponding port line to be an output. 
In the Junior Computer the four registers have been assigned the 
following address locations: 
PAD :$1A80 
PADD : $ 1A81 
PBD :$1A82 
PBDD :$1A83 
Now for a few examples to familiarise ourselves with port programming. 
To start with, several port lines are to be programmed either as inputs or 
outputs. 
1. All the port lines belonging to port A are to be inputs, while ail those 
belonging to port B are to be outputs. The program will then look like 
this: 
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LDA # @@ all bits in the accumulator are zero 
STA-PADD linesPA@...PA7 are inputs 
LDA # FF ali bits in the accumulator are ones 
STA-PBDD lines PB@...PB7 are outputs 
As you know, the individual bits in the port data direction register deter- 
mine whether a port line is an input or an output. In the data direction 
register PADD they are all noughts, so that the port A lines are all pro- 
grammed as inputs. The CPU can now read the data on the port lines and 
enter that data into the accumulator, the X register or the Y register. This 
will be further described later on. In the data direction register PBDD all 
the bits are ones, causing all the lines to port B to be programmed as 
Outputs. The CPU can now write any bit pattern onto the port lines by 
way of the data bus. Again, this will be expanded on later. 
2. Port lines PA4 and PB@ are to be outputs; the other port lines are to be 

inputs. The following bit patterns are therefore entered into the two 
data direction registers: 
PADD b7 b6 b5 b4 b3 b2 bi b@ 

06616 6 @ @ 
PBDD b7 b6 b5 b4 b3 b2 b1 b@ 
‘6606 6 @ 1 

The program for the above will be: 
LDA #10 load accumulator with required bit pattern 
STA-PADD line PA4 is an output 
LDA # @1 load accumulator with required bit pattern 
STA-PBDD tine PB@ is an output | 
All the other port lines are programmed as inputs. 


Reading from and writing to the port lines 


We now know that the port lines can be programmed as inputs or outputs 

by the information contained in the data direction registers, but how can 

the microprocessor read or write data from or to them? This facility is 

provided by the two data registers, PAD and PBD. 

Reading port lines PA@ ... PA7 and PB@.. . PB7 

When the data registers PAD or PBD are read, the bit pattern on the port 

lines at that moment is transferred, via the data bus, to one of the internal 

CPU registers. In other words, the port lines are an extension of the data 

bus. If the processor is to read one or more port lines, they must be pro- 

grammed as inputs. 

The following example illustrates this: 

LDA # 00 

STA-PADD PA@...PA7 are programmed as inputs 

LDX-PAD _ the bit pattern on the port lines is stored in the X register 
of the CPU 

If the bit pattern at port A is 19101119, 


PA7 PA6 PA5 PA4 PA3 PA2 PA1 PA®@ Port A lines 
1 0 1 0 1 1 1 @ bit pattern 


the hexadecimal number AE will be stored in the X register. 
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lf the voltage on a particular port line is less than 0.4 V, the micropro- 
cessor will interpret it as logic ‘@’’. The voltage must be greater than 2.4 V 
for a logic ““1”’ to be read. 


Note: If a port line programmed as an input is connected to the output of 
a gate, a transistor or another type of logic device, a current of up to 
1.6 mA could be produced. This must be taken into account, especially 
when connecting certain CMOS ICs, so as not to destroy the particular 
device. When the microprocessor reads the port lines the bit pattern 
present at that moment will be transferred to one of the CPU registers. 
Port lines programmed as inputs do not therefore, have a latch function. 


Writing to port lines PA@ .. . PA7 or PB@ ... . PB7 

When writing to data registers PAD or PBD, the bit pattern contained in 
one of the CPU registers will be transferred to the port lines, which can be 
considered as an extension of the data bus. If the processor is to write to 
one or more port lines, they must be programmed as outputs. This is 
illustrated by the following: 


LDA # FF 

STA-PADD PAQ@...PA7 are programmed as outputs 

LDX # C3 | 
STX-PAD the bit pattern contained in the X register is transferred to 


port A lines. 
The contents of the X register is C3 = 11000011. This bit pattern will 
appear on port lines PA7... PAQ: 
PA7 PA6 PAS PA4 PA3 PA2 PA1 PA@ portA lines 
1 1 0 0 0 0 1 1 


The hexadecimal number C3 will remain on the port fines until the next 
write operation (latch function). 

Note: If a port line programmed as an output is connected to the input 
of a gate, a transistor or another type of logic device, these may not draw 
more than 1.6 mA from the output port. The port lines are only capable 
of driving one standard TTL load. If TTL compatibility is not required, 
port lines PB@...PB7 may be used as a current source to directly drive 
the base of a transistor switch (maximum of 3 mA at 1.5 V). 

Warning! The port lines of the PIA are not protected against excess voltage 
or current. When they are directly connected to an external device such as 
a printer, the voltage at the port lines should be prevented from exceeding 
+7 V or from becoming negative, for then the 6532 is likely to go up in 
smoke!! 


First steps 


Now that we have discovered all there is to Know about port lines, it is 

high time to write a short demonstration program which uses all four 1/0 

registers. The program should achieve the foliowing: 

1. At port A the state of eight switches is to be read by the CPU. 

2. The Junior Computer is to convert this information into an audible 
signal. 

3. The signal is to be fed out of PB@. An amplifier must be provided to 
control a small 8 Q2 loudspeaker. 
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Figure 3. The hardware required for the DEMO program of figure 4. The bit pattern 
produced by the (closed) switches is read into the computer via port A. This 
information is then converted into a squarewave signal which is fed to the 
loudspeaker amplifier via port line PB@. 


4. A circuit diagram must be drawn to show how these requirements are 
to be met. 
5. Subsequently, a flow chart must be drawn so that the program can be 
entered into the computer via the editor and then assembled. 
Points 1...3 will be fulfilled by the program itself. Point 4 tackles the 
problem by producing a circuit diagram. This is given in figure 3 and shows 
how eight switches S@...S7 are connected to port lines PA@...PA7. 
Since the Junior Computer must read the state of these switches (whether 
they are on or off), all port A lines must be programmed as inputs. An 
audible signal is to be produced at PB@, this line must, therefore, be 
programmed as an output. Transistor T1 is included to enable the signal to 
be heard via a loudspeaker. This completes the necessary hardware to solve 
the problem. : 
Next, the software, the program (point 5) must be developed. Figure 4 
gives a program which converts the switch information into a particular 
frequency or squarewave. It should be noted that this program is not 
particularly elegant, but it serves the purpose of illustrating how the four 
1/O registers PAD, PADD, PBD and PBDD are controlled. 
At the start of the demonstration program, DEMO, port lines PA@. . . PA7 
are programmed as inputs and port line PB@ as an output. All the bits in 
the data direction register PADD are zero and b@ in the data direction 
register PBDD is a one. This situation will remain unchanged throughout 
the program. The following part of our program involves the frequency 
loop (label FREQ). Here, the processor reads the state of the switches 
S@...S7 into the accumulator. Prior to this we must decide whether a 
closed switch corresponds to a logic one or to a logic nought level: 
— a closed switch is logic 1 
— an open switch is logic @ 
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Figure 4. The flowchart of the DEMO program which, with the hardware from 
figure 3, will produce a separate tone for each individual key (or combination of 
keys). The program can be entered into the Junior Computer with the aid of the 
editor and assembler contained in the monitor program. 
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After the bit pattern present on the port lines has been copied into the 
accumulator (LDA-PAD), it must be inverted: EOR # FF. An audible 
signal must now be produced which is dependent on the switch informa- 
tion. The easiest way to achieve this is to alternately set the output port 
line PB@ high and low for a certain amount of time. This will effectively 
produce a squarewave signal which can be rendered audible by means of 
the loudspeaker interface connected to PBO. 

The Y register is used to ‘swing’ the port line PB@ high and low. The 
least significant bit (b@) alternates from nought to one and is copied into 
the data register PBD. Subroutine DELAY determines the length of time 
that is high or low. Here the CPU copies the bit pattern of the switch 
information into the X register (TAX). Then the X register is decremented 
until it becomes zero. The amount of time this process takes depends on 
the state of the switches. Thus, the processor is able to generate a whole 
range of frequencies. 


Editing and assembling the DEMO program 


Once the flow chart has been drawn up, the program can be entered into 
the computer. It is to be assembled in page zero, where locations 
0000... OGEO are available. For this reason the BEGAD pointer is set to 
0000 and the ENDAD pointer to @@E@. By placing the start address of 
the assembler 1F51 in locations 1A7A and 1A7B (the NMI vector), the 
assembler can be started by pressing the ST key. The editor will then be 
exited from via a non-maskable interrupt. The ‘‘keying-in” procedure 
shown below illustrates how the DEMO program is entered: 


key board display comments 

RST 

AD 6060 E 2 @GE2 XX 

DA 6 @ Q@GE2 OO 

A ae one ae ; BEGAD = 0000 

+ E @ QGE4 EG 

‘ a a, } ENDAD = O0E@ 

AD 1ATA TATA XX 

DA 5 1 1A7A 51 NMI vector = 1F51 

= 1 =F 1A7B 1F (start address of assembler) 
AD 1 CB 5 1CB5 20 start address of editor 
GO 77 editor running 
INSERT FF106906 0 FF 10 00 label 10: DEMO 
INPUT A200 @ A200 LDX # 00 

INPUT 8 E 8 11 A 8E 811A STX-PADD 

INPUT E 8 Es INX 

INPUT 8 E83 1A 8E83 1A STX-PBDD 

INPUT F F416 @ FF 11 60 label 11: FREQ 
INPUT ADs @1 A AD8@O1A LDA-PAD 

INPUT 49 F F 49 FF EOR # FF 

INPUT Ado @ AG GO LDY # 00 

INPUT 8 C 8 21 A 8C821A STY-PBD 

INPUT 2612 6 @ 20 12 00 JSR-DELAY (labe! 12) 
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iNPUT C 8 C8 INY 

INPUT 8 C8 21é6A 8C 82 1A STY-PBD 

INPUT 20% 2 0 @ 20 12 00 JSR-DELAY (tabel 12) 
t{NPUT 4C11 90 @ 4C 11 00 JMP-F REQ (label 11) 
INPUT F F420 @ FF 12 G@ label 12: DELAY 
INPUT A A AA TAX 

INPUT F F433 0 @ FF 13 00 label 13: DEL. 

INPUT CA CA DE X 

i{NPUT Dot 3 D@13 BNE to label 13 
INPUT 6 @ 60 RTS 

ST  XXXX XX start assembler via NMI 
AD 606090 0 0000 A2 start address of DEMO 
GO start DEMO 


Music on the Junior Computer 


Tunes can be played on the Junior Computer by connecting a small key- 
board to port lines. The melody played can be heard via a simple loud- 
speaker interface. Construction of the Junior “piano” involves the follo- 
wing requirements: | 

1. The keyboard should have black and white keys similar to that of a 
piano or organ. 

2. The keys should be arranged in an electrical matrix and the entire 
keyboard must be connected to port A. 

3. The tones must be audiblie!! 

A summary of the requirements is given in figure 5. It includes: 

— a plano keyboard 

— a key matrix with connections to port A 

— anamplifier circuit connected to port line PB@. 

As the keys are arranged in a matrix (figure 5), each key can be assigned 

a certain value. The matrix format is 4 times 4. The rows are designated 

as ROW@... ROW 3 and the columns as COL @...COL 3. The values 

of the individual keys are also indicated. Figure 5 also shows an alternative 
construction for the keyboard using Digitast switches. 

Since all the keys are connected to only one port (port A), some of the 

port Jines must be used as inputs and some as outputs. Thus: 

— Columns COL @...COL-3 are connected to PA@...PA3. Since the 
computer has to read the column information to calculate key values, 
port lines PA@.. . PA3 will have to be inputs. 

— Rows ROW®@...ROW3 are connected to PA4...PA7 and must 
become logic @ one after the other, so that the computer can detect 
whether a key is depressed, identify it and calculate its value. As the 
computer has to write certain patterns onto matrix rows ROW@.. 
.. ROW 3, port lines PA4...PA7 must be outputs. 

We have already seen how to connect a simple loudspeaker interface. 

Again, PB@ ist to be programmed as the sound output. 

This covers the mechanical and electrical structure of the “piano” key- 

board. Let us now develop a short program that will enable a tune to be 

played on the keyboard. It must be constructed step by step and should 
comprise the following: 
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Figure 5. The hardware required for the PLAY program (see figure 7). The keys are 
arranged in a four-by-four matrix (5a). Each key will produce a separate note. The 
frequency codes for each of these notes are contained in the look-up table DEL 
(see figure 10). Figure 5b shows a possible layout for an inexpensive alternative to a 
(proper) piano keyboard. 
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— aroutine to calculate the values of the 16 keys 

— aroutine to establish whether any key is depressed 

— aroutine to ‘‘debounce” the keys 

—~ a routine to allocate a particular frequency to each key that is 
depressed 

~— a look-up table in which the 16 key frequencies are stored 

Figure 6 shows the flowchart of a program to calculate the value of the 

16 keys. Since it scans the key matrix given in figure 5 the !/0 lines of port 

A must be programmed before the processor jumps to this subroutine 

(KEYVAL). As we know, port lines PA7...PA4 are outputs and PA3.. 

..PA@ are inputs. Thus, the data direction register belonging to port A 

must be loaded with the bit pattern 11110000 = F@. This can be accom- 

plished by the instructions: 

LDA # F@ 

STA-PADD 

All the 1/0 lines for port A have now been programmed and the subroutine 

KEYVAL can be called. During its description the key matrix in figure 5 

and the flowchart in figure 6 will be referred to. 

At the start of the routine memory location ROW is loaded with the 

value F7 (= 11110111). The X register operates as a row counter, its 

contents determine which row of the keyboard matrix is being read into 

the computer via port A: 

X = 03 corresponds to ROW @ 

X = 02 corresponds to ROW 1 

X = 01 corresponds to ROW 2 

X = 0@ corresponds to ROW 3 


Each time the X register is decremented, the processor moves the contents 
of memory location ROW one bit position to the left and stores it in the 
data register PAD. As a result, the matrix lines will each go low in 
succession: 

X register PA7...PA4 


X = 04 1111 
X = 03 1110 
X = 62 1101 
X = 01 1011 
X= 00 0111 


As each individual matrix row goes low in turn, the processor can easily 
establish which key has been depressed in which row. If no key is 
depressed, port lines PA3...PA@ will all be high. The least significant 
“nibble” (four bits) of the data byte will therefore consist entirely of ones. 
If a single key is depressed, port lines PA3...PA@ will be 1110 or 1101 
or 1911 or 0111. If the least significant nibble contains several noughts, 
it means that several keys in the matrix row in question were depressed 
at the same time. 

Since the entire range of port A data register is read (LDA-PAD) the four 
most significant bits, which we are not interested in, must be masked 
out: 

LDA-PAD load information from port A into accumulator 

AND #0F mask out four most significant bits (@@@OX XXX) 


43 


9-9S1608 






eevi avd- vis ;O8 
ind3no = ¥ 6 # YQT 
va [ARN — ZVLS 


08 # D0Y 
913 
Xi 


d¢# GNV 
avd —- vot 


28a e6eu 
seUNGA MOd Pa 


L Aq sauna 
MOl WAaWSLEp 


(iz) VAa» 

ou 
$ = URC M01 wh# Xa fzy 
8 


60] MOY — ZV1S| S 











(2) cha ov 





Figure 6. The flowchart of the subroutine KEYVAL, which is used during the PLAY 
program. This sUbroutine calculates the value of a depressed key and stores that value 


in memory location KEY. 
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Then by comparing this information with @F (CMP # @F) and branching 
(BEQ), the processor establishes whether a key was depressed in the 
matrix row being scanned. When a row is found to contain a depressed 
key, the row number is saved in jocation TEMPX and the bit number of 
the column (PA3...PA@) in location KEY. 

In the next section of the program (KEYB) the X register will operate 
as a column counter (before, it acted as a row counter). The processor 
shifts the contents of KEY (= column information) one bit to the right 
until the carry flag is zero. If after four shift operations, the carry flag ts 
still high, there must be a fault in the program and the computer will try 
to calculate the key values once more (branch to label KEYVAL). If, 
however, the carry flag has been reset, the program will ask in which 
matrix row the key was depressed. This information is stored in the 
memory location TEMPX. By a series of simple comparisons (CMP) 
the true value of the key can now be established. 

The value of the keys increases by four after each row. The keys in ROW 1 
will therefore be four times greater than those in ROW @, the keys in ROW 
2 eight times greater and the keys in ROW 3 twelve times greater. By 
simply adding this value to the column number, the true key value can be 
found. Once the key value has been calculated, the computer stores it in 
location KEY under the section of program labelled KEYC. 

Finally, all the keyboard matrix rows are cleared before returning to the 
main routine. This is important for the next subroutine KEYIN (figure 8a) 
which is used to check whether any key has been depressed. If a key has 
been depressed, one of the matrix columns (PA3...PA@) must be logic 
0. Since KEYIN inverts the column pattern read (EOR # OF) it can be 
seen that: 

the contents of the accumulator = 0@, if no key is depressed 

the contents of the accumulator # 09, if a key is depressed. 

The next subroutine is called DELAY (see figure 8b). It is used to 
‘debounce’ a depressed key. The required delay is obtained by means of 
the loop DELA. 

Note: In chapter 7 of this book we will discuss the keyboard and display 
routines in the monitor program of the standard Junior Computer. The 
keyboard routine is very similar to the subroutine KEYVAL. Nevertheless, 
there is a considerable difference as far as programming the I/O is con- 
cerned. 

In KEYVAL one section of the port A lines acts as an input and the other 
as an output (matrix structure}. In the case of the monitor routines 
SCANDS, SCAND and GETKEY (described in the next chapter), the 
whole of port A is programmed as an input and the whole of port B as an 
Output during keyboard scanning. 

The flowchart of the main routine PLAY is shown in figure 7. This routine 
assigns a certain frequency to each key that is depressed and renders a 
tune audible via the loudspeaker. Each of the required port lines are 
defined at the start of this program: 

— PA7/...PA4 are outputs 

— PA3...PAQ@ are inputs 

— PB@ isan output 

When label PA is reached the Junior Computer waits for a key to be 
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Figure 7. The flowchart of the main portion of the PLAY program. This program 
decodes the value of a depressed key and converts it into an audible tone. During this 
procedure the processor utilises the look-up table DEL to determine the actual 


frequency of the note to be played. 
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Figure 8. The flowcharts of the subroutines KEYIN, DELAY and EQUAL are also 
used by the PLAY program. Subroutine KEY!IN detects whether or not a key is 
depressed while DELAY ‘debounces’ the key. Subroutine EQUAL is incorporated to 
ensure that the mark/space ratio of the generated squarewave signal is equal. 
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depressed. This is detected by means of the subroutine KEYIN (figure 8a). 
Once a depressed key is detected the program jumps to the subroutine 
DELAY (figure 8b), which debounces the keyboard. After this, the 
computer runs through the subroutine KEYIN once more to check whether 
the key is still depressed. Only then will the computer calculate the value 
of the depressed key by jumping to the subroutine KEYVAL (figure 6). 
The key value is yet to be converted into a frequency. This happens after 
label TONE. Before considering the details, let’s look at the TONE routine 
as a whole: 
— label TONE: the loudspeaker is switched ‘on’ for a certain length of 
time. The actual duration will be determined by the pro- 
gram loop TA...BNE...TA and will depend on the contents of the 
X register. Before the computer reaches this program loop, it loads a num- 
ber (delay) corresponding to the frequency of the depressed key into the 
X register. The value of this frequency is stored in the look-up table DEL, 
the sturcture of which will be considered later. 
— label TB: the loudspeaker is switched ‘off’ for a certain length of time. 
The off time is determined by the program loop TB.. 
..BNE...TB. Again, the duration of the program loop depends on the 
contents of the X register. As can be seen from the flowchart, the micro- 
processor jumps repeatedly to the subroutine KEYIN to check whether 
the key is still depressed. If so, a squarewave signal will appear at PBQ. 
If, however, the key has now been released, the program will branch to 
label PA where it will wait for a new key to be depressed. 


The look-up table and frequency values 


Before the values of the delays for each frequency can be calculated for 
the look-up table, the program loops TA...BNE...TA and TB.. 
.. BNE...TB must be examined. At the start of TB the CPU jumps to 
the subroutine KEYIN, carries out the subsequent BEQ instruction without 
branching and, if a key is depressed, decrements the X register before 
branching back to label TB. All the instructions require a certain period 
of time for execution. The execution times for the relevant instructions 
are listed below: 


JSR-KEYIN = 6ys 

LDA-PAD = 4us 

AND #@F = 2us 

EOR#@F = 2us 

RTS = 6uySs 

BEQ = 2 sno branch while the key is depressed 
DEX = 2us 

BNE-TB = 3s branch Is executed 

total = 2/7 us 


The loop time therefore lasts 27 us times the contents of the X register. 
The loop TA...BNE... TA must also last 27 ys. Since no jump is made 
to the subroutine KEYIN, the loop time will have to be corrected. That is 
why the subroutine EQUAL (figure 8c) is included to supplement the 
missing 22 us. This is shown in the form of a graph in figure 9. 
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X times 


Figure 9. This is how the Junior Computer actually manages to produce a squarewave 
signal at the output PB®. As can be seen, without the EQUAL subroutine the signal 
would be asymmetric. 


The above enables us to calculate the values for the look-up table. Figure 
10 shows some figures on the keys which call for a few words of expla- 
nation. If, for example, we take note ‘a’ with a frequency of 440 Hz, 
the relationship between time and frequency will be: 


mel 
f 
A frequency of 440 Hz therefore has a period of 
1 = 
440 Hz = 2273 LAS. 


On a piano keyboard the frequency of each note either rises or falls from 
key to key by a factor of 12/2 = 1.0594613. This enables frequencies 
or periods to be allocated to all the keys, as shown in figure 10. Further- 
more, the duration of both program loops is known to be 27 ps and so the 
exact delays for each key can be calculated. 

Let’s look at note ‘‘a’’ again. Its period is 2273 us and so the value for the 
delay in the look-up table must be: 

a = 84,6 = $54 us. 

Once the delay values for each key have been calculated the look-up table 
DEL can be completed. Since the microprocessor fetches the delay infor- 
mation for each note from the look-up table twice, the played notes will 
be an octave lower than those calculated. 

It is now time to enter the complete program PLAY including its sub- 
routines KEYVAL, KEYIN, DELAY and EQUAL into the computer. For 
this we utilise the editor and assembler contained in the monitor program. 
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key period dec hex address 


66 3C <> 1AGF 

63 3E + 1AGE 

67 43 < 1A9D 

71 47 <~ 1A0C 

75 4A <-> 1AGQB 

79 4E +> 1AGA 
220 Hz— 69 84 54 < 1AG9 

so 58 1898 

95 5E << 1A07 (Y = key value) 

100 64 << 1A06 

186 6A << 1AG5 

112 7@ + 1AGQ4 

119 77 <> 1AG3 

126 7E + 1AG2 

134 86 <> 1AG1 

ia ae: ns 
80915-6-10 





Figure 10. The ‘software keyboard’ of the PLAY program. The frequency of the note 
produced by each key of figure 5 is stored in the look-up table DEL (address location 
1AG@). 


Once the program has been assembled and the look-up table has been 
entered (page 1A), the keyboard and the loudspeaker interface can be 
connected to the PIA. 

The complete “keying in” procedure is given below: 


key: display: comments: 
RST XXXX XX 
AD 00 E 2 QQE2 xx 
DA 0 @ QQE2 OO 
EGAD = 0000 
+ oo ove3 oo + 8 
+ E @ QGE4 EO 
NDAD = 0@E@ 
+ 0 0 aves oo } © 
oe ba WAU NMi-vector = 1F51 
ae 2 aia (start address of assembler) 
+ 1 éF 1A7B 1F . 
AD 1 CB 5 1CB5 20 start address of editor 
GO 77 editor running 
INSERT A Q9 F @ AS FO LDA# F@ 
INPUT 8D8&11A 8D 811A STA-PADD 
INPUT A9Q@1 AS @1 LDA # 01 
INPUT 8D83 1A 8D 83 1A STA-PBDD 
INPUT 8D82 1A 8D 82 1A STA-PBD 
INPUT A9Q9@@ AY 60 LDA# 00 
INPUT 8D8@1A 8D 8@ 1A STA-PAD 
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key: 

INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 


TOMmMmMmMohL_ np raonrndAanNpwypPewornrrprwarprnrtnogonodonrnrnawDwaArypIOIonN TAWAYPIPNTNNN TAN TT 
Seo Ce OoOmnmnNucredognovaserpremnmnauvointesyssermmavuovrsryv SenrmMoonrssesseeset 
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WOpNSpma-trmNEeesoCoSs 


NY & 
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Qa o- — 
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eS 


display: 


FF 91 
20 28 
FO 91 
20 29 
20 28 
FQ 91 
20 20 
A4 DA 
FF 92 
AQ 00 


8D 82 


BE 00 
FF 93 
20 31 
CA 

DO 93 
AQ 01 
8D 82 
BE 00 
FF 94 
20 28 
Fo 91 
CA 

D@ 94 
F@ 92 
FF 20 
AQ F7 
85 D9 
A2 04 
FF 21 
CA 

3@ 20 
06 D9 
A5 D9 
8D 86 
AD 8@ 
29 OF 
C9 OF 
FO 21 
86 DB 
85 DA 
A2 00 
FF 22 
46 DA 
99 23 
Eg 

EO 04 
D@ 22 
FO 20 


00 
00 


00 
00 


00 
00 
1A 
1A 


06 
) 


1A 
1A 


00 


00 


00 


1A 
1A 


00 


comments: 


label 91: PA 

JSR-KEYIN (label 28) 
BEQ to PA (label 91) 
JSR-DELAY (label 29) 
JSR-KEYIN (label 28) 
BEQ to PA (label 91) 
JSR-KEYVAL (label 20) 
LDYZ-KEY (@@DA) 

label 92: TONE 

LDA# 60 

STA-PBD 

LOX-DEL,Y (DEL = 1A@Q) 
label 93: TA 
JSR-EQUAL (label 31) 
DEX 

BNE to TA (label 93) 
LDA# @1 

STA-PBD 

LDX-DEL,Y 

label 94: TB 
JSR-KEYIN (label 28) 
BEQ to PA (label 91) 
DEX 

BNE to TB (label 94) 
BEQ to TONE (label 92) 
label 20: KEYVAL 
LDA # F7 

STAZ-ROW (@0D9) 
LDX # @4 

label 21: KEYA 

DEX 

BMI to KEYVAL (label 20) 
ASLZ-ROW (@@0D9) 
LDAZ-ROW (@6D9) 
STA-PAD 

LDA-PAD 

AND # OF 

CMP # OF 

BEQ to KEYA (label 21) 
STXZ-TEMPX (@@6DB) 
STAZ-KEY (@@DA) 
LDX # 00 

label 22: KEYB 
LSRZ-KEY (@@DA) 
BCC to ROWA (label 23) 
INX 

CPX # 64 

BNE to KEYB (label 22) 
BEO to KEYVAL (label 20) 
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key: 

INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
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FF 23 
A5 DB 
C9 G3 
D@ 24 
8A 
4C 27 
FF 24 
C9 02 
DO 25 
8A 
18 
69 04 
D@ 27 
FF 25 
co 01 
D@ 26 
8A 
18 
69 08 
DO 27 
FF 26 
C9 00 
DG 20 
8A 
18 
69 OC 
FF 27 
85 DA 
AQ 00 
8D 8@ 
60 
FF 28 
AD 80 
29 OF 
49 OF 
60 
FF 29 
A@ FF 
FF 30 
88 
D® 30 
60 
FF 31 
EA 
EA 
EA 
EA 
EA 
60 


00 


00 
00 


00 


00 


00 


1A 


00 
1A 


00 


00 


00 


comments: 

label 23: ROWA 
LDAZ-TEMPX (@0DB) 
CMP # @3 

BNE to ROWB (label 24) 
TXA 

JMP-KEYC (label 27) 
label 24: ROWB 
CMP # 62 

BNE to ROWC (label 25) 
TXA 

CLC 

ADC # 04 

BNE to KEYC (label 27) 
label 25: ROWC 
CMP # @1 

BNE to ROWD (jabel 26) 
TXA 

CLC 

ADC # @8 

BNE to KEYC (label27) 
label 26: ROWD 

CMP # 00 

BNE to KEYVAL (label 2@) 
TXA 

CLC 

ADC # @C 

label 27: KEYC 
STAZ-KEY (@@DA) 
LDA # 00 

STA-PAD 

RTS 

label 28: KEYIN 
LDA-PAD 

AND # OF 

EOR # @F 

RTS 

label 29: DELAY 

LDY # FF 

label 36: DELA 

DEY 

BNE to DELA (label 3@) 
RTS 

label 31: EQUAL 

NOP 

NOP 

NOP 

NOP 

NOP 

RTS 


The program can then be tested for any errors that may have cropped up 
during entry: 


key: ete, 
SEARCHA 9 F @ } }+#£4=;°.,AAQ FO 
SKIP 8D 81 1A 
SKIP AQ 91 
SKIP 8D 83 1A 
SKIP 8D 82 1A 
SKIP | AY O¢6 
SKIP 8D 80 1A 
SKIP FF 91 @0 
SKIP 20 28 OO 
SKIP FO 91 
SKIP 20 29 00 


Once everything is correct the assembler can be started: 
key: display: 


ST = XXxXXxx 

key: display: 
AD 1A00 1A00 XX 
DA 8 E 1A@@ 8E 
+ 8 6 1A@1 86 
+ TE 1A@2 7E 
+ 77 1A@3 77 
+ 70 1A04 70 
+ 6A 1A05 6A 
+ 6 4 1A@6 64 
+ 5E 1A07 5E 
+ 59 1A08 59 
+ 54 1A@9 54 
+ 4e€ 1TAQ@A 4E 
+ 4A 1A0B 4A 
+ 47 1A@C 47 
+ 43 1AQD 43 
+ 3E 1AQE 3E 
+ 3 C TAOF 3C 


Finally, the program can be started: 


key: display: 
AD @ 6 6 @ G000A9 
GO 


Now you can have fun playing tunes on your Junior Computer! 
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The interval timer 


Another major feature of the Junior Computer is the interval timer which 
is also incorporated in the 6532 multi-function device. This timer is pro- 
grammable and operates independently from the microprocessor. This 
means that while the timer is operating, the CPU is at the disposal of the 
programmer, which is an obvious requirement if the operator is to work 
efficiently and effectively with the microcomputer. 

The interval timer and the PIA are both built into the same chip, thereby 
reducing the component count and the overall cost. These two important 
components increase the performance and versatility of the Junior 
Computer considerably. However, before being able to operate the interval 
timer we must know how it works. Let us therefore describe the internal 
structure of the timer and then develop a few demonstration programs to 
show how it can be used. 


Block diagram 
The block diagram of the interval timer is shown in figure 11. It consists 
of three sections: 
— Programmable register - timer: The timer register is eight bits wide and 
is connected to the data bus. It can be compared with an ordinary RAM 
location, for data may be written to or read from it. 
— Divider: The divider is connected to both address lines A@ and A1 and 
to the clock signal ®2. The programmable register and the divider com- 
bined constitute the complete interval timer. 
The interval timer may be compared to a pre-settable down counter (TTL 
or CMOS). Such a device can be preset to a certain binary number. Each 
clock pulse will then decrement the counter by one until its contents reach 
zero, 
This is exactly how the interval timer in the Junior Computer works. The 
clock signal 2 is the clock pulse for the interval timer which also counts 
down, With the aid of the divider the clock signal can be divided by four 
different factors. The dividing factor is determined by the information 
presented to address lines A®@ and A1. Thus: 


Al A@_ division factor 


0 Q +1T 

0 1 + 8T 

1 0 + 64T 

1 1 +1924T T= 1 us (in the Junior Computer) 


The clock signal ®2 is therefore divided by 1, 8, 64 or 1024 before it 
decrements the contents of the timer register by one. The following 
example serves to clarify this. 
With the aid of the CPU the number $ 1E is entered into the timer register 
and a division factor of 64 is selected by means of address lines A®@ and 
A1. The following will then be true: 

$ 1E = 3019 and 

3019 times 64,9 equals 19201 
In other words, when the timer register is preset to $ 1E and the division 
factor is 64, the contents of the timer register will become zero after 
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Figure 11. The block diagram of the interval timer contained in the PIA. It consists 
of three basic units. The programmable register (timer) can be likened to a 
presettable down counter. When data is entered into this register the interval timer 
will start to count down. The rate at which it counts is determined by the divider 
which allows division factors of 1, 8, 64 or 1924 to be selected. When the timer 
reaches the end of its count, the interrupt flag contained in the interrupt control unit 
is set. 


1920 ps. Before we can describe the interval timer in detail however, 
another important aspect of the 6532 IC has to be considered: the inter- 
rupt flag register. 

— Interrupt control: The interrupt control section of the interval timer 
contains the interrupt flag register which consists of two flags: the timer 
interrupt flag and the PA7 interrupt flag (to be discussed in greater detail 
later). The interrupt flag register is also 8 bits wide, but only two are used 
(b7 and b6) the remainder (b5...@) will always be zero when this 
register is read by the processor. The timer interrupt flag is set by the 
interval timer (as you may have expected!) and the PA7 interrupt flag is 
set by a positive or negative going pulse on port line PA7. When a read 
operation is performed on the interrupt flag register, the bits are trans- 
ferred to the processor on the data bus, as the diagram below indicates: 


b7 b6 b5 b4 b3 b2 bl b@ bit No. 
X X @ @ 0 G@ DO B@ 
PA7 flag 
‘timer flag 


The PA7 flag is reset when the interrupt flag register is read. The timer flag 
is cleared when the timer register is accessed (either written to or read 
from). 





When is the timer flag set? 


Bit b7 in the interrupt flag register is used as the timer flag. This is set 
(b7 = 1) when the timer has reached a ‘time out’. With respect to the 
previous example this will be: 
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timer register contents 


1E = 00011110 
1E = 00011101 
1C = 00011100 
1B = 00011011 


02 = 00000010 
01 = 00000001 
00 = 00000000 
FF = 11111111 
FE = 11111110 
FD = 11111101 


comments 

starting value of the timer register 
after 64 us 

after a further 64 ps 
after a further 64 ys 

30 x 64 us = 1920 us 

until the timer register 
is Zero 


after a further 64 ps 

after a further 64 ps (time out) 
after one ps timer flag is set 
after another ps 

after another ps 


after another ps 
after another ps 
after another us 
after another ps 
after another pus 


®2 = 00000010 
01 = 00000001 
00 = 00000000 
FF = 11111111 
FE = 11111110 


It should now be clear how the Interrupt flag register works in conjunction 
with the interval timer. Once the CPU has entered a number — the initial 
counter setting — into the timer register and the division factor has been 
determined during the write operation by address lines A@ and A1, the 
interval timer will start its ‘countdown’. With a division factor of 64 and 
an initial counter setting of 1E = 3Q,9, the contents of the timer register 
will become zero after 1920 us. The moment at which the timer register 
contents becomes zero is termed the ‘time out’. 


Points to note: 


1. The timer flag in the interrupt flag register is reset (logic @) when the 
timer register is read (read locations RDTEN or RDTDIS). 

2. The timer flag is also reset when something is entered into the timer 
register (write into locations CNTA ... CNTH). The timer flag is there- 
fore always reset when the timer is started (when the initial counter 
setting is entered). , 

3. The timer flag in the interrupt flag register is set (logic 1) after the time 
out. In our example: 
initial setting = 1E = 3@i0 
division factor = 64 
time out after 30 x 64 us = 1920 us 
the timer flag is set after 1920 + 1 = 1921 us 
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4. After the time out the division factor is set to one automatically. This 
is independent of the division factor which was previously selected. If 
this were 64, for instance, then: 

— before the time out the contents of the timer register are dec- 
remented by one every 64 pus 

— after the time out the contents of the timer register are decremented 
by one every 1 ys. One microsecond corresponds to 1 MHz — the 
clock frequency of the Junior Computer. 

The interrupt flag register also controls the interrupt line connected to the 

IRQ input of the microprocessor. If the interrupt flag (I) in the status 

register of the CPU is reset, the 6532 can cause an interrupt request (I RQ). 

The IRQ line will then go low. 

The interrupt request line is controlled by both flags in the interrupt flag 

register. If either the timer flag belonging to the interval timer or the PA7 

flag is set, the IRQ fine can go low to cause an interrupt. The programmer, 
however, is able to prevent the interrupt flag register from causing an IRQ. 

Address line A3 is connected to the interrupt flag register and is used to 

enable or disable the !RQ line: 

— A3= Q@to disable interrupt from timer to |RO 

— A3= 1 to enable interrupt from timer to |RO 


Summary 


This completes the description of the interval timer block diagram. To sum 
up, it consists of a divider, a programmable register (the timer) and an 
interrupt control section. The latter contains the interrupt flag register In 
which there are two flags: the timer interrupt flag (b7) and the PA/ 
interrupt flag (b6). These two flags can be used to control the interrupt 
request line (IRO) of the microprocessor. Note that the instructions SEI 
and CLI (set interrupt disable and clear interrupt flag) in the main program 
have an over-riding effect on the above. 

The timer interrupt flag will be reset after a read or write operation from 
or to the programmable register or after an interrupt occurs. This flag is 
only set (b7=1) one microsecond after a time out. (Note that if the 
interrupt occurs at the same time that the timer is read, the interrupt flag 
will not be reset). 

In addition to its use as a peripheral input/output line, the PAZ pin can 
function as an edge sensitive input. In this mode, an active transition on 
the PA7 line will set the internal interrupt flag (b6 of the interrupt flag 
register). Providing the PA7 interrupt is enabled, the |RQ output will then 
go low. When this occurs, of course, the CPU will branch to an interrupt 
routine. 


Internal structure of the interval timer: timer mode 


Now that the block diagram of the interval timer has been fully explained, 

it is time to take a close look at the ‘insides’ of the device. Figure 12 gives 

a clear indication of what the interval timer and the interrupt flag register 

look like as far as the programmer is concerned. 

1. The interval timer can be looked upon as having a total of eight data 
registers. In the Junior Computer they have been given the names: 
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CNTA, CNTB, CNTC, CNTD, CNTE, CNTF, CNTG and CNTH. Each 
of these data registers can be individually addressed and have been 
allocated locations 1AF4...1AF7 and 1AFC...1AFF respectively. 

2. The contents of the data registers can be altered by the processor by 
means of a write operation. 

3. Each data register has been assigned a specific division factor: 

CLK1T = divide by 1; CNTA and CBTE 

CLK8T = divide by 8; CNTB and CNTF 

CLK64T = divide by 64; CNTC and CNTG 

CLK1KT = divide by 1924; CNTD and CNTH 

The division factor is effectively the number of ®2 clock pulses that 
must pass before the contents of the programmable register (timer) are 
decremented by one. 

4. The interval timer is split into two sections of four data registers each. 
One is made up from the registers CNTA ... CNTD and the other from 
registers CNTE ... CNTH. 

5. If the processor enters data into one of the registers CNTA ...CNTD, 
the interval timer will be started. The division factor will be determined 
by which of the registers is being used. During the write operation the 
timer interrupt flag will automatically be reset (b7 in the interrupt flag 
register = Q). In addition, the |RQ line will go high and the timer will be 
inhibited from causing an interrupt. The timer interrupt flag will be set 
after the timer has reached the time out (contents of the programmable 
register = FF). 

6. /RQ mode: \f the processor enters data into one of the registers 
CNTE...CNTH, the interval timer will again be started. As above, the 
division factor will be determined by which of the registers is used, the 
interrupt timer flag will be reset and the IRQ line will go high. This 
time however, the timer will be able to cause an interrupt. After the 
time out has been reached, the timer interrupt flag will be set and the 
IRQ line will be taken low causing an interrupt request (provided, of 
course, that the interrupt flag in the status register of the CPU is reset: 
CLI). 

7. The computer is also able to read the instantaneous value of the con- 
tents of the programmable timer register. When the data register 
RDTDIS is read (address location 1AD4) the period of time remaining 
(before the time out) can be determined. This read operation will cause 
the timer interrupt request to be inhibited. 


Figure 12. The data and control registers of the interval timer and the edge detector. 
The interval timer is started by entering information into one of the data registers 
CNTA ...CNTH. The amount of time left before, or elapsed since, a time out can be 
established by reading one of the data registers RDTDIS or ROTEN. The former, 
along with data registers CNTA ...CNTD, will place the interval timer in the polling 
mode and disable the interrupt request line. The latter, along with data registers 
CNTE ...CNTH, will enable the interrupt request line. The state of the flags in the 
interrupt flag register can be examined by reading the data register RDFLAG. The 
four control registers EDETA ... EDETD determine the polarity of the pulse to be 
detected on PA7. Control registers EDETA and EDETB place the edge detector in 
the polling mode and control registers EDETC and EDETD place the edge detector in 
the interrupt mode. 
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division factor name and 
address 


CLKIT x xX XXX XK X X CNTA = 1AF4 
CLK8T x XX XX XK XK X CNTB = TAFS 


CLK64T CNTC = 1AF6 


disable timer ~ IRQ 


IRQ fine: 1 xs 
CLK1KT CNTD = 1AF7 


| 


time out 


RDTODIS = 1A04 


enabie timer — [RQ CLK1T xX XX XX XK X CNTE = 1AFC 


IRQ line: 1 us 
CLK8T x xX X XK K K X CNTF = 1AFD 


CLK64T CNTG = 1AFE 


CLK1KT Xx xX XX X X K X CNTH = 1AFF 


name and 
address 


stn To] ]o]o[] sorene- 0 


PA?7-flag 


flags flag register 


polling- name and 
mode address 


edge 
disable PA7 — 
isable 7 —IRQ x xX XxX XX XK X EDETA = 1AE4 
‘—— | Gaz L. 


| 
_ 7 wo 
IRQ line: @ =m IRQ. 
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On the other hand, when the data register RDTEN is read (address 
location 1ADC) the remaining period of time can again be determined, 
but this operation will enable the interrupt request. 

By reading the data registers RDTDIS and RDTEN the interval timer 
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can be switched from the polling mode (see section 8) to the interrupt 
mode or vice versa. The read operation will not alter the contents of the 
timer register, but will merely convey an idea of the state it is in at that 
particular moment. If this takes place before the time out, the division 
factor which was previously introduced will be maintained. When 
RDTDIS and RDTEN are read after the time out, the elapsed time (the 
period of time since the time out occurred) can be calculated by comp- 
lementing the value read and adding one (two’s complement). 

lf we now return to our previous example and load data register CNTG 
with an initial timer value of 1£ (decimal 3@) the division factor will be 
set at 64 and the interrupt will be enabled. The period of time between 
the start of the interval timer and the IRQ line going low (and the timer 
interrupt flag being set) will be (30 x 64) + 1 = 1921 us. 

The operation of the interval timer and how its contents can be read in 
the interrupt mode are illustrated by the following ‘flow chart’: 


IRQMOD 





(Ciear interrupt flag - processor) 

The interval timer is started by loading the value 1E into 
data register CNTG. This enables the timer interrupt 
request and selects a division factor of 64. (The timer 
interrupt flag is reset). 


Sh ithe: Behe at diene oe & hw ee A ea a ea t=@ 
The processor continues with the main program execution 
. totally independent from the interval timer 
(A = @C) 
LDA-RDTEND eka kde bee ee Se Bee eS t= 1152 us 
. The data register RDTEN is read prior to the time out. 
* The contents are @C (= decimal 12) therefore there are 
: (12 x 64) + 1 = 769 us to go before the interrupt. 
bok. athe et ah Selgin anne eee ae t= 1926 ys 


ge ies Ips Rebates nly, cae ee Sek tase fee Sec oe, eae, MA Sis Be ewe t = 1921 us 
Jump to the interrupt routine. If the data registers 
RDTDIS and ROTEN are read during this routine, the 
interrupt timer flag and the !1RQ line will be reset 
(multiple interrupts!). 
Return from interrupt routine. 





° The processor has returned to main program execution 
° and continues to operate independently from the 
: interval timer. 


7 (A = A4 = 1910610@) = —92 decimal) 


EDA-ROTEN| S63 Eitae a dO aee Be mweion Seales t= 2013 us 


. (Since the interrupt 92 us have passed, the two’s 

. complement of A4 is 5C (= 92 decimal). 

. (The contents of the interval timer are decremented by 
: one every microsecond until it is restarted by the 

° processor). 


8. Polling mode: The timer can also be operated in what is described as 
the polling mode. This means that the programmable timer register con- 
tents can be tested periodically to see whether a time out has occurred. 
In this mode of operation the interrupt request line is disabled by 
writing into one of the data registers CNTA...CNTD. The contents 
of the interval timer can then be checked by reading the data register 
RDTDIS (keeping the interrupt request line disabled). Alternatively, 
the contents of data register RDFLAG (address location 1AD5 can be 
examined to see whether the timer interrupt flag (in the interrupt flag 
register) has been set. Therefore, the properties of the interval timer can 
still be used to their full advantage while Jeaving the interrupt request 
line free for another (external) device. 

The following example shows the same program sequence but this time in 
the polling mode. For this a new instruction will be introduced, which was 
not discussed in Book |: BIT. The BIT instruction enables certain bits tn 
any (programmable) memory location to be tested. Therefore, the con- 
tents of the interrupt flag register can also be tested with this new instruc- 
tion. (Actually, it’s been around for some time). The general operation of 
the BIT instruction is as follows: 

* AAM _ The contents of the accumulator are ANDed bit by bit with 
the contents of the memory location. The previous contents of 
the accumulator are not altered by this instruction (similar to 
the CMP instruction). However, the Z-flag in the CPU status 
register is affected by the result of the AND operation (Z = 1 
if result = @). Either zero page or absolute addressing can be 
used for the BIT instruction. 

* M,>N if the contents of the tested memory location are negative, 
b7 of that location will be ‘one’ and, after the BIT instruction, 
the N-flag in the CPU status register will be set. Effectively, b7 
of the memory location is copied into the status register 
(N-flag). 

* Me V_ If b6 of the tested memory location is ‘one’ the V-flag (over- 
flow) in the status register will be set. Again, b6 is copied into 
the status register. 

As we know, the interrupt flag register in the interval timer consists of two 

flags: b7 is the timer interrupt flag and b6 is the PA7 interrupt flag. The 

state of these flags can therefore be determined by reading data register 
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RDFLAG. By using the BIT instruction together with a suitable branch 
instruction only five memory locations are required for the whole pro- 
cedure. The relevant branch instructions for testing these flags are listed 
below: 
a. to test the timer interrupt flag (timer in polling mode): 

BPL: branch if N-flag = timer interrupt flag = @ 

BMI: branch if N-flag = timer interrupt flag = 1 
b. to test the PA7 interrupt flag (PA7 in polling mode): 

BVC: branch if V-flag = PA7 interrupt flag = @ 

BVS: branch if V-flag = PA7 interrupt flag = 1 
If the processor writes into one of the data registers CNTA...CNTD, the 
interval timer will be started, the interrupt flag will be reset and the 
interrupt request tine will be disabled. The interval timer will then be in 
the polling mode. 
If we use data register CNTC (instead of CNTG) in our previous example, 
the division factor will still be 64, but this time no interrupt is possible. To 
detect when a time out occurs, therefore, we need to examine the contents 
of the interrupt flag register to see when the interrupt flag (b7) is set. To 
do this, all that is required is to examine the contents of the data register 
RDFLAG as illustrated below: 


POLMOD 


LDA 1E (initial value of timer = 1E) 
SUASCNVC I) satirist tec a beg Gates cde ian hy Gas al pM t=@0 





. (uP and timer operate independently) 


LDA-RDTDIS (A = OC; not yet time out) 





iE 4! Ie ses ach y" te Sia bat Secdes By Ge ge Cae eae ee he OY Seca we t=1152 ys 
. (Another 769 ys to go) 
. (uP and timer operate independent!y) 
BP is Saco tes, ek Abe ta: Ge i Sign see sae eal tal GR) “Vee WW san, Sela t = 1921 us 
(time out) 
LDA-RDTDIS (A = A4 = 10100100 = —92 decimal) 
aed ce, acc ah ane te be eek Gan Gas Se cnc t= 2013 us 


(92 us have elapsed since the interrupt flag was set) 
etc. | 
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The interval timer is again loaded with the initial value of 1E. This means, 

as we now well know, that the timer interrupt flag will be set after 1921 us 

(CNTC has a division factor of 64). The first time that the data register 

RDTDIS is read the timer has not yet reached the time out therefore the 

timer interrupt flag will not be reset (as it has not yet been set!!). The 

processor and the timer will continue to operate independently until! the 
loop POLL. Here, the data register RDFLAG is continually interrogated 
until the timer interrupt flag is set (1 us after the time out). As soon as the 
interrupt flag is set the processor will continue with the main program 
operation (again, independently from the timer). When the data register 

RDTDIS is read the second time, the timer interrupt flag will be reset and 

will remain so until the next time out (256 us) or until new information is 

entered into one of the data registers. 

9. As we are well aware, the timer may operate either in the polling mode 
or in the interrupt mode. In some instances it may be desirable to alter- 
nate between the two modes of operation. This means, for example, 
that if the timer is operating in the polling mode, and the timer inter- 
rupt flag has not yet been set, the programmer can put the interval 
timer into the interrupt mode without having to start it afresh. This can 
be accomplished by storing the contents of the accumulator on the 
stack, reading the data register RDTEN and then replacing the contents 
of the stack in the accumulator. Thus: 


The interval timer is operating in the polling mode. 










LDA-RDTEN 


. The interval timer will now operate 
: in the interrupt mode 


Save the contents of the accumulator on the stack. 
Change to interrupt mode 
Restore previous accumulator contents 


It follows therefore, that the operation of the interval timer can also be 
changed from the interrupt mode to the polling mode: 


The interval timer is operating in the 
interrupt mode 

Save the contents of the accumulator 
Change to polling mode 

Restore previous accumulator contents 





The interval timer will now operate in 
. the polling mode 
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In both cases, the contents of the programmable timer register are 
unaffected and the division factor will not alter when the data register 
is read. 

10. Reading from and writing to the interval timer 


a. 


Reading the data registers RDTDIS, RDTEN and RDFLAG 

The microprocessor is able to read the instantaneous value of the 
data registers RDTDIS and RDTEN. From this information it can 
calculate how much time is left before a time out occurs, or how 
much time has elapsed since the time out. 

Reading the data register RDTDIS causes the interval timer to be 
placed in the polling mode and disables the interrupt request line. 
The timer interrupt flag is set after a time out. 

Reading the data register RDTEN causes the interval timer to be 
placed in the interrupt mode. 

When a time out occurs, the timer interrupt flag is set and the 1ROQ 
line is pulled low to cause an interrupt request. 

By reading the data register RDFLAG, the processor can determine 
whether or not the timer interrupt flag has been set or not. 

The division factors 1, 8, 64 or 1024 are preset depending on 
which of the data registers CNTA...CNTH are written into. 
Reading any of the data registers RDTDIS, RDTEN or RDFLAG 
will not affect the division factor, if this is done before a time out. 
If one of the data registers RDTDIS or RDTEN is read after a time 
out, the timer interrupt flag and the interrupt request line will both 
be reset. The timer interrupt flag will not be reset, however, if the 
interrupt occurs at the same time the data register is read. 

When the interval timer causes an interrupt request, the micro- 
processor will branch to an interrupt (sub)routine. It is advisable 
to start this routine by reading the data register RDTDIS so that 
the timer interrupt flag and the interrupt request line are reset. 
This will prevent the same interrupt routine from being run when 
the processor returns to the main program. 


. Writing into data registers CNTA ... CNTH 


Writing into one of the data registers CNTA...CNTD causes the 
interval timer to be started in the polling mode. The division factor 
is also established and will not change until the time out occurs. 
Writing into one of the data registers CNTE ...CNTH causes the 
interval timer to be started in the interrupt mode. The division 
factor is again established and will not change until the time out 
occurs. 

When information is entered into one of the data registers CNTA .. 
.. CNTH, the timer interrupt flag and the interrupt request line are 
both reset. 


This concludes the description of the interval timer. We have now dis- 
covered how to use eleven data registers and the timer interrupt flag. We 
are also familiar with the two modes of operation: the polling mode and 
the interrupt mode. However, before we can put all this theory into 
practice, yet another important aspect of the PIA is still to be discussed: 
the edge detector. 
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Edge detection: the PA7 mode 


The peripheral interface adapter is capable of detecting pulses. The struc- 
ture of the edge detector is very simple; it has one input and one output. 
Its input is port tine PA7 and its output is the interrupt request line. The 
edge detector can be programmed to activate the interrupt request line 
when there is either a positive or negative pulse transition on the PA7/ 
input line. When a pulse is detected, b6 in the interrupt flag register will be 
set. /f the microprocessor is to operate in conjunction with the edge 
detector, port line PA7 must be programmed as an input. 

The programmer has the option of preventing the edge detector from 
causing an interrupt request. As shown in figure 12, the edge detector con- 
sists of four ‘control registers’: 
EDETA; address location 1AE4 
EDETB; address location 1AE5 
EDETC; address location 1AE6 
EDETD; address location 1AE7 
The contro} registers EDETA and EDETC are used when a negative going 
pulse is to be detected and registers EDETB and EDETD are used to detect 
positive going pulses. When control registers EDETA and EDETB are used 
the edge detector will be placed in the polling mode and the interrupt 
request line will be disabled. When control registers EDETC and EDETD 
are used the edge detector will be placed in the interrupt mode and the 
interrupt request line will be enabled. 

Two common applications for the edge detector are shown in figure 13. 
The first of these uses port line PA7 as a serial data input and the second 
uses all eight of the port A input/output lines (programmed as inputs) to 
transfer a 7-bit ASCII code from a keyboard to the computer. 


polling mode 


interrupt mode 


Serial input 
As we know from Book |, the majority of data manipulated inside the 
computer is transferred in parallel form (byte by byte). However, the 
computer is also capable of transferring data serially. 
Serial data transfer is an economical method of conveying information and 
is absolutely necessary if the computer is to be connected to a printer, 
a video terminal or other such peripheral device. The most often used 
method of serial data transfer is the ASCI! (American Standard Code for 
Information Interchange) code which, as can be seen from figure 13a, 
consists of the following components: 
1. one start bit 
2. eight data bits (b@.. . b7) 
3. one parity bit 
4. two stop bits 
More often than not, only seven of the eight available data bits are actually 
used. A complete breakdown of the ASCII code will be given in the Junior 
Computer Book III. 
A certain bit time, t2, is assigned to each bit in the serial data train. The 
time interval between each (expected) data bit is therefore constant. The 
duration of the start bit is 1% times the duration of the bit time, and, as 
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there are two stop bits, the duration of the stop bits is twice that of the 
bit time. 
The transfer of serial data is always preceded by the start bit. This means 
that when the serial data input line to the particular device is high, the 
computer understands that there is no data to be input. However, when 
the serial input line goes low it means that information is on its way. This 
level transition can easily be detected by the edge detector of the periph- 
eral interface adapter. In the given example the edge detector must be 
programmed to react to a negative going pulse transition (the start bit 
going low). Once the computer has recognised a start bit by means of the 
edge detector, it is no trouble at all for it to read in the serial data train: 

1, The start bit is recognised (negative going pulse on port line PA7) 

2. The computer waits for 1% bit times and then ‘tests’ the signal level 
on PAZ. In other words, it checks whether the logic level at the serial 
input is high or low. In this way it can assign the value @ or 1 to the 
first data bit. One bit period later the second data bit will arrive at the 
serial input. Again the processor tests to see whether the logic level is 
high or low. This process is repeated until the last data bit (b7) is read 
into the computer. Each bit is tested halfway through a bit period. 

3. One bit period after the last data bit is read the parity bit arrives at the 
serial data input. This bit is used for testing purposes and informs the 
processor whether the serial data stream that has just been transferred 
contains an even or odd number of ones or noughts. It is then a simple 
task for the computer to establish whether an error has occurred during 
the data transfer. . 

4. The serial data transfer is then ended by two stop bits. It should be 
noted that both stop bits have the opposite polarity to the start bit 
(start bit is low, stop bits are high). 

5. The microprocessor will then wait for the next negative going pulse on 
the serial data input line (PA7). As soon as the edge detector receives 
this information the above procedure is repeated. 


Parallel input 


As we know, the Junior Computer is also capable of reading paralle! input 
signals at port A (or at port B for that matter). Figure 13b shows the 
connections required to transfer data from an ASCII keyboard to the 
computer. When a key is depressed the (ASCII) code for that key is output 
from the keyboard in parallel form. Seven of the available bits are used 
for the actual code. As soon as the key code is stable on the data fines 
b@...b6, the keyboard will generate a ‘strobe’ pulse. The eighth data bit 
(b7) is used for the data strobe and when this line goes high the key code 
will be accepted by the computer (as this is the line that is connected to 
the edge detector). In other words, when a positive going pulse is detected 
on port line PA7 the stable key data can be read into the computer. 

These two applications illustrate the operation and possible uses for the 
edge detector. When data is to be transferred between the computer and 
certain peripheral devices connected to it, the edge detector becomes 
absolutely indispensable. Several other uses for the edge detector will be 
described in Book I11. 
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Figure 13. Two practical examples of the possible uses of the edge detector: serial (a) 
and paraliel (b) data entry into the Junior Computer via port A. It is clear that prior 
to using the edge detector, port line PA7 should be programmed as an input. 


Programming the edge detector 

As far as software is concerned, the edge detector consists of four ‘control’ 
registers. As shown in figure 12, these are EDETA, EDETB, EDETC and 
EDETD. When data is entered into one of these control registers, the edge 
detector is programmed to react to a positive or negative going pulse on 
port line PA7 (EDETA and EDETC for negative going pulses, EDETB and 
EDETD for positive going pulses). 

The edge detector operates in conjunction with the imternipt flag register 
inside the PIA. Here, bit 6 is the flag for the edge detector and is referred 
to as the PA7 interrupt flag. If, for example, the edge detector is pro- 
grammed to react to a negative going pulse on PA7 and such a pulse 
occurs, the PA/ interrupt flag in the interrupt flag register will be set. Of 
course, if it is programmed to detect positive going pulses, the latter type 
will cause the same reaction. 

Similarly, such pulses can be used to control the interrupt request line. If 
the programmer wishes to enable an edge detector interrupt request (by 
entering any bit pattern into one of the control registers EDETC or 
EDETD), the interrupt request line of the PIA will go low the moment 
the PA7 interrupt flag is set. Thus, the following similarities exist between 
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the timer interrupt flag and the PA7 interrupt flag: 

— the timer interrupt flag is set one microsecond after a time out occurs. 
Provided the timer has been programmed to enable the interrupt 
request, the IRQ tine will go low the moment the timer interrupt flag is 
set. 

— the PA7 interrupt flag is set when a pulse transition is detected at the 
PA7 input. Provided the edge detector has been programmed to enable 
the interrupt request, the [RQ line will go low as soon as the PA7 inter- 
rupt flag is set. 


Summary 


The timer interrupt flag and the PA7 interrupt flag are both incorporated 
in the interrupt flag register of the PIA. Both are independent of each 
other and both can be scanned in the polling mode by using the BIT 
instruction: 


BIT-RDFLAG test the timer interrupt flag 


BPL has the timer interrupt flag been set? 
. if so, continue; if not, loop 


BIT-RDFLAG test the PA7 interrupt flag 
BVC has the PA7 interrupt flag been set? 
. if so, continue; if not, loop 


By writing into one of the control registers the edge detector is pro- 
grammed to respond to a positive going or negative going pulse on PAZ. 
Entering a random bit pattern into control registers EDETA or EDETB 
prevents an interrupt request when the PA7 interrupt flag is set. If the 
edge detector is to cause an interrupt request when a certain pulse is 
detected, data will have to be entered into the control registers EDETC 
or EDETD. The following examples should clarify the situation: 


STA-EDETA or the edge detector responds to a negative going 
STX-EDETA or pulse on PA7, the PA7 interrupt flag will be 
STY-EDETA set, but the [RQ line is disabled 

STA-EDETB or the edge detector responds to a positive going 
STX-EDETB or puise on PA7, the PA7 interrupt flag will be 
STY-EDETB set, but the IRQ line is disabled 
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STY-EDETC set and the 1RQ line is enabled 
STA-EDETD or 


STX-EDETD or 
STY-EDETD 


the edge detector responds to a positive going 
pulse on PA7, the PA7 interrupt flag will be 


STA-EDETC or the edge detector responds to a negative going 
STX-EDETC or pulse on PA7, the PA7 interrupt flag will be 
set and the IRQ line is enabled 


Further comments on the PIA 


As we already know, the timer and the edge detector operate in conjunc- 
tion with the interrupt flag register. The timer interrupt flag (b7) and the 
PA7 interrupt flag (b6) are set after a time out and a pulse transition on 
PA7 respectively. If the programmer permits the timer or the edge detector 
to cause an interrupt request, the IRQ line will go low as soon as the timer 
interrupt flag or the PA7 interrupt flag is set. To prevent the same inter- 
rupt request from being caused several times, the |RQ line must be reset as 
soon as the interrupt is serviced (in the interrupt routine). When resetting 
the IRQ line, the following points should be borne in mind: 

1. The interval timer causes an IRQ: \f the programmer has enabled the 
interval timer to cause an interrupt request, the timer interrupt flag is 
set after the time out and the IRQ line will go low. The processor will 
now branch to an interrupt routine. At the start of this routine the IRQ 
line must be reset, so that the same timer IRQ cannot be caused after 
the return to the main program (RTI). The timer interrupt flag and the 
{RQ line can be reset during the interrupt routine by writing into data 
registers CNTA...CNTH or by reading one of the data registers 
RDTDIS or RDTEN. When one of the data registers CNTA...CNTH 
is written into, the interval timer starts afresh and defines whether the 
timer should cause a further interrupt request or not. When data 
registers RDTDIS or RDTEN are read, the interval timer does not start 
from scratch, but only defines whether the interrupt request is enabled 
or disabled. 

2. The edge detector causes an IRQ: \f the programmer has enabled the 
edge detector to cause an interrupt request, the PA7 interrupt flag is set 
after a certain pulse transition has been detected at the PA7 input and 
the IRQ fine will go low. The processor will now branch to an interrupt 
routine. At the start of this routine the IRQ line must be reset, to 
prevent the same PA7 IRQ from being caused a second time once the 
processor has returned to the main program. The PA7 interrupt flag and 
the IRQ line can be reset by reading the contents of the interrupt flag 
register RDFLAG. 

3. The IRQ vector: Memory locations 1A7E and 1A7F in the Junior 
Computer are reserved for the interrupt request vector. This means that 
the computer is able to determine or alter the [RO vector during the 
course of a program. This enables the interval timer and the edge 
detector to be allotted their very own interrupt routines. 

By reading the interrupt flag register RDFLAG the processor can deter- 
mine which of the two devices causes the interrupt request. If, for 
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example, the timer interrupt flag was set, the processor will set the IRO 

vector to the start of the timer interrupt routine and otherwise to the 

start of the PA7 interrupt routine. When very high processing speeds are 
required, it is often necessary to incorporate several ‘interlaced’ inter- 
rupt routines. This aspect will be considered in greater detail in 

Book III. 

4. The reset line RES: The Junior Computer is initiated when the reset 
line is taken low. This line also affects various registers inside the PIA. 
When the reset line (RES) goes low the following will happen: 

1. The contents of all the input/output registers are cleared. Thus, all 
port A and port B lines are declared inputs. Peripheral devices are 
die unable to inadvertently destroy the output registers PAD and 

BD. 

2. No interval timer or PA7 interrupt request can be caused. Thus, it is 
impossible for the processor to branch to an interrupt routine — for 
which no IRQ vector has yet been set. 

3. The RES signal programs the edge detector to respond to a negative 
going pulse on PA7. During the reset, however, the PA7 interrupt 
flag may be accidentally set by a peripheral device. Before the edge 
detector is used therefore, it is good practice to reset the PA7 inter- 
rupt flag by reading the interrupt flag register RDFLAG. 

This completes the discussion of the PIA. The following program 

examples show how to utilise the interval timer and the PIA. The edge 

detector has been deliberately omitted as it will be dealt with in the next 
book. Figure 14 shows the complete block diagram of the 6532 IC. It 
gives the internal structure of the PIA, the interval timer, the edge detector 
and the RAM memory. The software configuration of these components 
is shown in figure 15. The address locations required for the micropro- 
cessor to access the various PIA registers are also shown. Address line A7 is 


PAG PAT Pee PB? 







DATA 
OUTPUT PERIPHERAL PERIPHERAL OUTPUT DIRECTION 
REGISTER DATA SUFFER DATA BUFFER REGISTER 
REGISTER 
A A B B B 


EDGE DETECTOR 


DATA 
DIRECTION 
REGISTER 
A 











INTERNAL BUS 
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Figure 14. The block diagram of the multi-function peripheral interface adapter. The 
input/output ports, the data direction registers, the interval timer, the edge detector 
and the 128 bytes of RAM are all interconnected via the internal (data) bus. 
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Figure 15. This table gives the information required to address the individual data 
and control registers of the PIA. Address line A7 is used to select between the 
128 bytes of RAM and the functions of the interval timer and the edge detector. 


used as the RS line for the PIA (RS = RAM Select). When this line is low 
the 128 RAM locations in the PIA can be addressed. If, however, RS is 
high, the CPU can access the interval timer, the input/output registers or 
the edge detector. Therefore, address locations 1A@@...1A7F belong to 
the RAM memory and locations 1A8@...1AFF will address the various 
registers. It should be noted that not all the address locations from 
1A80...1AFF are actually used. This is because the address decoding 
pertaining to the 6532 chips is incomplete. 


Operating the interval timer in the interrupt mode 


After all this theory concerning the interval timer etc, it is high time to put 
what we have learnt into practice. For this purpose we will write two pro- 
grams: INPUT and REPEAT. The first of these two programs will make it 
possible to enter a tune into the Junior Computer with the aid of the key- 
board given in figure 5. The tune can then be played back by means of the 
second program. 

Since the remainder of this chapter serves to explain how to program the 
interval timer, we will refer to subroutines developed earlier for the PLAY 
program. The subroutines KEYIN, KEYVAL and EQUAL are of particular 
interest. We can also adopt the keyboard and loudspeaker interface with- 
out having to modify anything. 

The problem to be solved here concerns the entering of a tune into the 
Junior Computer, which the computer will then repeat automatically. 
What information do we have to enter into the computer? Two factors are 
involved when playing a note: 
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. The pitch or frequency of the note. In the PLAY program it was seen 


how each key that was depressed was assigned a separate frequency. 
The same principle also applies to the INPUT program. 


. If the computer is to repeat the entered melody it must know the 


length of time that each of the keys was depressed. Therefore, the 
duration of each note must also be ascertained. This can be measured 
quite simply by utilising the interval timer. 


Thus, the computer must store both the frequency of the tone and the 
period of time that each key was depressed. Two memory locations must 
therefore be reserved for each note in the melody to be played. The 
frequency of the note depends on the value of the key. Since there are 
sixteen keys available, the value of each key will be between @...F. The 
interval timer will measure the time duration for which a key is depressed 
and will assign a value of between @@.. . FF to it. 


The INPUT program 


The entry routine INPUT must fulfil the following requirements: 


1. 


2. 
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When a key is depressed a tone corresponding to the value of that key 
should be heard from the loudspeaker. 

Simultaneously, the computer must determine the length of time that 
the key was depressed for. Since two events are apparently happening 
at the same time, usual program techniques will no longer be valid. For 
this reason we will have to resort to using interrupt routines so that we 
are able to execute two parallel events on the Junior Computer. 


. Every key that is depressed must have a particular value assigned to it. 


This is specified by the computer during the KEYVAL subroutine. 


. It must be possible to scan the keyboard at a very high speed. This in 


fact poses no problems due to the subroutine KEYIN. Once a depressed 
key is detected, it must be debounced, which ts taken care of by the 
(well known) DELAY routine. 


. When the key is released, the loudspeaker should go quiet and the 


value of the key together with the length of time it was depressed 
must be stored. These values must be stored in the memory locations 
0100... @1D8 of page 1. If this memory area happens to be filled, the 
computer must jump back to the monitor program and ignore the key- 
board. 


. Before a melody can be stored in the Junior Computer, the ‘melody 


memory’ must be prepared. This involves filling the entire melody 
memory with the ‘dummy’ value 77 and setting a pointer to the initial 
are location. 


. The key value must be stored first followed by the length of time that 


the key was depressed. !f, for instance, the keys 9, A, B and C (values) 
are depressed in that order, the following information must be stored 
in the melody memory: 


Address: Data: 


0100 @9 = key value 
0101 WW =600...FF = duration of depressed key 
0102 QA = key value 


0193 XX =@@...FF = duration of depressed key 


0104 @B =key value 

0105 YY =0@...FF = duration of depressed key 
0106 @C = key value 

0107 ZZ =60...FF = duration of depressed key 
0108 77 =dummy value 

0109 77 

@1D7 77 

01D8 77 = end of melody memory 


All the above requirements are met by the INPUT program, the flow chart 
of which is shown in figure 16. Initially, the program disables the interrupt 
request line with the instruction SEI. As a result, no accidental interrupts 
can be caused. The computer then sets the IRQ vector to point to address 
location 1A2@, the start address of the interrupt routine |ROIN (figure 
17a), which determines the length of time a key is depressed. We will 
return to that later. 

Next, the input/output ports of the PIA are programmed. As shown in 
figure 5, the keyboard matrix is connected to port A. Lines PA7...PA4 
are programmed as outputs and lines PA3...PA@ are programmed as 
inputs. The loudspeaker interface is connected to port line PB@. This line 
will therefore have to be programmed as an output. | 

Furthermore, the NOTE pointer for the melody memory (figure 17b) has 
to be set. This pointer indicates an address location on page 1, in which 
the value of the next key to be depressed is to be stored. Initially, there- 
fore, this pointer will point to address location @10@. The end address of 
the melody memory is 01D8. If the NOTE pointer exceeds this address, 
the Junior Computer must jump back to the monitor program. Thus, the 
value $ D8 is stored in location ENDL. A comparison of the low order 
address byte of the NOTE pointer with the contents of ENDL will deter- 
mine whether or not the memory area is full. 

The computer has now reached the label INA. Here, the melody memory 
area from locations 0100... @1D8 are filled with the dummy value of 77. 
The computer then scans the keyboard. If no key has been depressed, it 
will remain in the loop KEYSCN -BEQ-KEYSCN. If, however, the 
contents of the accumulator are not equal to zero following a return from 
the KEYIN routine, a key must have been depressed. The key is then 
debounced by the subroutine DELAY (figure 8b) and if the key is still 
depressed after this, the processor will jump to the subroutine KEYVAL 
(figure 6) where it will calculate the value of that key. Since there are 
16 possible keys, the value will be in the range 90... @F. The calculated 
key value is then stored in location KEY after the return to the main 
program. The flow charts of all the subroutines involved are given in 
figures 6 and 8. They were described in detail in relation to the PLAY 
program. 

And now the fun begins!! Once the value of the depressed key has been 
determined, the computer has to produce a tone from the loudspeaker. To 
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INPUT 
as 
Ds 


Ad LDA # 26 
8D | STA —IRQL 
a9 
re 


8D} STA —PADD 


AQ LDA #@1 


8D | STA —PBDD | 1A83 


8D | STA —-PBD 1A82 


8D ISTA — NOTEH } @0DD 


TATE 


1481 


AG LDY -— 0 


8c | STY -—PAD 1] 1A8@ 
84 |STY — NOTEL]| 9@DC 


AG LOY #08 
84 | STY — ENDL | GDF 
Ag LDA #77 





91 
88 
60 


STAZ-INOTEL).Y 1 DC 
DEY 
CPY # FF 






: @ 


yes 
20 ([_bevay_1]@9) 
20 [Kevin 1] Ze) 


2 @) 


yes 


20 [[xevva_]] (20) 


AS] LDA #00 


85 ISTA—LENGTH] DE 


AQT LDA # FF 


8D] STA —CNTG [TAFE 
58 


A4] LDYZ — KEY ] DA 


disable interrupts 
binary arithmetic 


IRQ-vector points to start address of 
interrupt 


routine FROIN 

{1A2@) 
PA]... PA4 = outputs 
PA3 .. .PAQ = inputs 
PB7 ...PB1 = inputs 
PBG = output 


NOTEH < @1 


™e 


Y<-o o190 
PA7...PA4 =9@ 
NOTEL < @¢ 
Y¥ «D8 
ENDL < D8 
AcT77 
ROW * $8909 
KEY * $O8DA 
TEMPX * $66DB 
* 
71>! CNOTE+¥] NOTEL $880C 
NOTEH * $88DD 
Y<Y-1 
LENGTH * $@@DE 
ENOL * $OODF 
DEL * $1A00 
all locations 
77? IROL * $1A7E 
IROH * $TA7F 
tRQIN * $1A2¢ 
RESET * $1C1D 
CNTA * $1AF4 
CNTG * SIAFE 
PAD * $1A8¢@ 
key depressed? PADD * $1484 
PBD * $1A82 
debounce PBDD * $1A83 
key depressed? 
calculate key value 
reset tone length 
start interval timer 
80915-6-16 


enable interrupts 
load key value 


achieve this the processor uses the same !ook-up table (DEL) as it did for 
the PLAY program (see figure 10). This is done following the label TONE 
— this section of the program is identical to that of the program PLAY. 

Meanwhile the length of time the key is depressed must also be calculated. 
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(rome) ® ve 


DEL: 1AGG 8E 
1A01 86 
1A82 PBG=¢ 1AG2 7E 
1A90 fetch delay 1Ag3 77 


1A94 70 

1A95 6A 

1A06 64 

1AG7 5E 

1A98 59 

1Ag9 54 

noe 1AGA 4E 

1AGB 4A 

‘X= 9? 1AgC 47 

1AGD 43 

AGE 3E 

1A82 PBO=1 1AQF 3 
1A00_— fetch delay 









8D 
BE 


wait 22 us 







STORE 


8D JSTAZ—~CNTA | TAF4 disable IRO 
AS [LDAZ~-NOTEL] DC A<NOTEL 


C5 |CMPZ — ENDL] OF 


? 
Fg (7) memory full? @) 
yes 
no 


98 TYA 
4c | JMP — RESET] 1010 


AG LDY #0 


$1 | staz-inore.iy | DC key value p1 


cs INY 


AS ILDAZ-LENGTH] DE 


STA2-(NOTEL).Y | DC duration p1 “e 


E6 |INCZ —NOTEL} DC } 
F6 [INCZ —NOTEL} oc _f NOTE < NOTE +2 


4c | JMP—KEYSCN} 12 wait for next key 


© 
= 
rc 


80915-6-16 


Figure 16. The flowchart of the INPUT program is very similar to that of the PLAY 
program given in figure 7. The main difference is that this time the played melody is 
stored in the memory of the Junior Computer. 
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This is done by means of interrupt programming. A few more instructions 
have been inserted between the jump to soubroutine KEYVAL and the 
label TONE. These instructions perform the following operations: 
*The contents of memory location LENGTH will be equal to the length 
of time the key is depressed. Before the computer can produce a tone 
for the specific key, the contents of LENGTH must be reset (LDA 09, 
STAZ-LENGTH). The value $ FF is then entered into the programmable 
timer register CNTG to start the interval timer. As we (should) know 
(by now), this will enable the interrupt request line and preset the division 
factor to 64. This means that the timer interrupt flag will be set and the 
interrupt request line will go low 16,321 microseconds after the data 
register CNTG was written into (255 x 64) + 1 = 16,321 ys). 


save accumulator contents 


DE increment LENGTH by one 


INCZ — LENGTH 


STA —CNTG 1AFE _ start interval timer 


restore previous accumulator contents 





80915-6-17a 












NOTE 1 
LENGTH 1 
NOTE 2 
LENGTH 2 
NOTE 3 
LENGTH 3 
NOTE 4 


LENGTH 4 


80915-6-17b 


Figure 17. The interrupt routine {RQIN (a) is used by the INPUT program to 
determine the length of time the key is depressed. Figure 17b shows how the key 
value and its duration are stored in the melody memory. 
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When the interval timer is started the interrupt request line of the PIA is 
enabled. The next instruction in the program (CLI) clears the interrupt 
flag of the CPU and enables its interrupt request line. Therefore, if the 
interval timer causes an interrupt request the CPU will be able to acknowl- 
edge the interrupt. 

Only now will the computer start producing a tone. For this it fetches the 
value of the depressed key from location KEY followed by the frequency 
of the note to be played from the look-up table DEL. The loudspeaker is 
then switched on and off in exactly the same way as for the PLAY 
program. While the tone is being produced the keyboard is scanned by the 
subroutine KEYIN to check whether the key is still being depressed. While 
the key remains depressed, the Junior Computer will continue to produce 
a tone. 7 

As the interval timer operates independently from the CPU, the timer will 
Cause an interrupt request after 16,321 us. The interrupt request line will 
then be pulled low and the computer will branch to the interrupt routine 
{ROIN (figure 17c). At the start of the interrupt routine the contents of 
the accumulator are saved on the stack (PHA) and then the contents of 
location LENGTH are incremented by one. The CPU then restarts the 
interval timer (LDA #FF, STA-CNTG) and enables the IRO line once 
more. The interval timer will again operate independently from the CPU. 
Before returning from the interrupt routine the previous accumulator 
contents are restored (PLA). 

Once the computer has returned to the main program it will recommence 
producing the tone until the key is released. After 16320 us the interval 
timer will have again reached a time out following which the computer will 
branch to the interrupt routine once more, thereby incrementing the 
contents of location LENGTH by one. The maximum duration that can be 
measured while a key is depressed is therefore: 


255 x 64 x 255 = 4161600 us = 4.1616 seconds 


initial timer value division factor maximum contents of LENGTH 


(not counting the time required by the processor to service the interrupt 
routine). Thus, while producing a tone, the computer can simultaneously 
measure how long a key is depressed. The maximum duration can there- 
fore be up to four seconds. If this period is exceeded, the processor wilt 
measure an incorrect time. No error will be reported (to keep the program 
as simple as possible). 

Each time an interrupt request occurs the computer will leave the tone 
producing routine (TONE) to which it returns once the interrupt routine 
has been executed. The CPU then runs through the subroutine KEYIN to 
check whether the key has been released. If the key has been released, the 
processor will return to the TONE routine with a value of zero in the 
accumulator. Thus, the processor will stop producing the tone and will 
branch to the STORE routine. All the details concerning the key that has 
just been released will have been stored in memory locations KEY and 
LENGTH. 

In the meantime, however, the interval timer could have caused another 
interrupt request which would lead to miscalculation of the length of time 
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the key was depressed. To prevent the interval timer from losing control of 
the situation after leaving the TONE loop, further interrupt requests are 
disabled. For this reason the data register CNTA is loaded with zero, 
although any of the data registers CNTA...CNTD could have been used 
instead. By writing into one of these data registers the interval timer is 
prevented from causing an interrupt request. 

The computer then compares the low order address byte of the NOTE 
pointer with the contents of location ENDL to find out whether or not all 
of the melody memory area has been filled up. If so, the CPU will return 
to the monitor program. If not, the processor will transfer the contents of 
locations KEY and LENGTH into the melody memory. The dummy value 
of 77, which was present previously, will be overwritten by the data 
concerning the key. The CPU will then modify the NOTE pointer 
(2 x INCZ-NOTEL) so that it points to a new address where the value of 
the next key to be depressed will be stored. The computer will then wait 
until the next key is operated. 

The memory area from 0200 .. . @3F F was chosen for the INPUT program. 
After editing the program the assembler is started with the ST key. How- 
ever, before this can be done, and before the editor is started, the correct 
NMI vector data will have to be stored in locations 1A7A and 1A7B. These 
two locations should contain the start address of the assembler program 
(1F51). 

After the INPUT program has been assembled, the look-up table (DEL) 
and the interrupt routine will have to be loaded, into the Junior Computer. 
When everything has at last been loaded, the INPUT program can be 
started. Provided, of course, that the keyboard is connected. As in the 
PLAY program, a tune can then be played on the keyboard. The only 
difference being that this time the tune will be stored in the melody 
memory. The details for the entry of the complete INPUT program are 
given below: 


key: display: comments: 

RST XXXX XX call monitor 

AD @@E2 @OE2 XX 

DA 00 Q@OE2 G60 

: ae aka ae t BEGAD = 0200 

+ FF QOE4 FF 

: a Bae ge ' ENDAD = @3FF 
AD TATA 1A7A XX 

DA 5 1 1A7A 51 NMI vector = 1F51 
+ 1 F 1A7B 1F (start assembler with ST) 
AD 1CBS5 1CB5 20 start editor 

GO 77 editor running 
INSERT FF1@60@6 FF 10 00 label 10: INPUT 
INPUT 78 78 SEI 

INPUT D8 D8 CLD 

INPUT A92@ AQ 20 LDA #20 

INPUT 8D7E1A 8D 7E 1A STA-IROL 
INPUT AS17A AY 1A LDA #1A 


INPUT 8D7FI1A 8D 7F 1A STA-IRQH 
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key: 

INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 


AQ977 
FF1190@0 
971DC 


rPOONTMOyp 
oSsepemmao 
o- S80 9e 


oe- 


display: 


AQ FO 
8D 81 
AQ @1 
8D 83 
8D 82 
85 DD 
Ad 00 
8C 80 
84 DC 
AO D8 
84 DF 
AQ 77 
FF 11 
91 DC 
88 

CO FF 
De@ 11 
FF 12 
20 28 
FO 12 
20 29 
20 28 
FO 12 
20 20 
AQ 00 
85 DE 
AQ FF 
8D FE 
58 

A4 DA 
FF 13 
AQ 00 
8D 82 
BE 00 
FF 14 
20 31 
CA 

DO 14 
AQ @1 
8D 82 
BE 00 
FF 15 
20 28 
FO 16 
CA 

D@ 15 
F@ 13 
FF 16 
8D F4 


1A 
1A 
1A 


1A 


00 


00 
G0 


60 
00 


00 


00 


1A 
1A 
60 
00 


TA 
1A 


00 


00 
1A 


comments: 

LDA #F@ 

STAPADD 

LDA #@1 

STA-PBDD 

STA-PBD 

STAZ-NOTEH 

LDY #00 

STY-PAD 
STYZ-NOTEL 

LDY #D8 

STYZ ENDL 

LDA #77 

label 11: INA 
STA-(NOTEL),Y 

DEY 

CPY #FF 

BNE to INA (label 11) 
label 12: KEYSCN 
JSR-KEYIN (label 28) 
BEQ to KEYSCN (label 12) 
JSR-DELAY (label 29) 
JSR-KEYIN (label! 28) 
BEO to KEYSCN (label 12) 
JSR-KEYVAL (label 20) 
LDA #00 
STAZ-LENGTH 

LDA #FF 

STA-CNTG 

CLI 

LDYZ-KEY 

label 13: TONE 

LDA #060 

STA-PBD 

LDX-DEL,Y 

label 14: TA 
JSR-EQUAL (label 31) 
DEX 

BNE to TA (label 14) 
LDA #61 

STA-PBD 

LDX-DEL,Y 

label 15: TB 
JSR-KEYIN (label 28) 
BEQ to STORE (label 16) 
DEX 

BNE to TB (label 15) 
BEQ to TONE (label 13) 
label 16: STORE 
STA-CNTA 
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key: 

INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 


INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
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A5DC 
CS DF 
FQ17 
98 

A@O@ 
971DC 
C8 

A5 DE 
91DC 
E6DC 
E6DC 
4C12 
FF? 
4c1i0D 


FF2Q 
AQ F?7 
85 D9 
A204 
FF21 
CA 

340290 
@6D9 
A5D9 
8D8@6 
AD8 @ 
29QF 
COQF 
F@21 
86DB 
85 DA 
A200 


FF226@ 


46DA 
99023 
E 8 

E@@O4 
D@22 
FQ@26 


FF23694 


A5 DB 
C903 
D@24 
8A 


aoguaonr 
peono 
N@nmN 
oN & ~s 


— © & 
Oso & 


> > 


a & 
Qa o& 


display: 


Ad DC 
C5 DF 
FQ@ 17 
98 

Ad 00 
91 DC 
C8 

AS DE 
91 DC 
E6 DC 
E6 DC 
4C 12 
FF 17 
4C 1D 


FF 20 
AQ F7 
85 D9 
A2 64 
FF 21 
CA 

30 20 
@6 D9 
Ad DY 
8D 80 
AD 80 
29 OF 
C9 OF 
FO 21 
86 DB 


85 DA 


A2 6@ 


FF 22 60 
46 DA 


90 23 
E8 

E® 04 
D@ 22 
FO 20 


FF 23 60 


AS DB 
C9 03 
D@ 24 
8A 


4C 27 60 
FF 24 00 


C9 62 
D@ 25 
8A 


comments: 
LDAZ-NOTEL 
CMPZ-ENDL 

BEQ to ST (label 17) 
TYA 

LDY #00 
STA-(NOTEL),Y 

INY 

LDA-LENGTH 
STA-(NOTEL), Y 
INC-NOTEL 
INC-NOTEL 
JMP-KEYSCN (label 12) 
labe! 17 (ST) 
JMP-RESET 

last INPUT instruction 
label 26: KEYVAL 

LDA #F7 

STAZ-ROW (@@D9) 
LDX #@4 

label 21: KEYA 

DEX 

BMI to KEYVAL (label 20) 
ASLZ-ROW (@0D9) 
LDAZ-ROW (6@D9) 
STA-PAD 

LDA-PAD 

AND #@F 

CMP #0F 

BEO # KEYA (label 21) 
STXZ-TEMPX (@0DB) 
STAZ-KEY (@@DA) 
LOX #00 

label 22: KEYB 
LSRZ-KEY (@@DA) 
BCC to ROWA (label 23) 
INX 

CPX #04 

BNE to KEYB (label 22) 
BEQ to KEYVAL (label 20) 
label 23: ROWA 
LDAZ-TEMPX (@6DB) 
CMP #93 

BNE to ROWB (label 24) 
TXA 

JMP-KEYC (label 27) 
label 24: ROWB 

CMP #@2 

BNE to ROWC (label 25) 
TXA 


key: 

INPUT 
iNPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 


NOaNON & 
Oo- an tb 
1 
> 


NOnNN & 


onowpseonseomaps O7nSYO © 
Qaoown © 
S 
S 


ONM-WAOOMTMOMW“WOOTNIO= 


DA 


AQOFF 
FF3000 
8 8 
DO34 
6 @ 
FF31900 
EA 

EA 

EA 

EA 

EA 

6 @ 


display: 
18 

69 64 
DO 27 

FF 25 60 
C9 61 

DO 26 

8A 

18 

69 68 
D® 27 

FF 26 00 
C9 00 
DO 26 

8A 

18 

69 6C 
FF 27 00 
85 DA 
AS 60 

8D 80 1A 
60 

FF 28 @@6 
AD 80 1A 
29 OF 
49 OF 
60 

FF 29 00 
AO FF 
FF 30 00 
88 

D® 30 

60 

FF 31 @0 
EA 

EA 

EA 

EA 

EA 

60 


comments: 

CLC 

ADC #04 

BNE to KEYC (label 27) 
label 25: ROWC 

CMP #@1 

BNE to ROWD (label 26) 
TXA 

CLC 

ADC #48 

BNE to KEYC (label 27) 
label 26: ROWD 

CMP #60 

BNE to KEYVAL (label 20) 
TXA 

CLC 

ADC #@C 

labef 27: KEYC 
STAZ-KEY (@@DA) 
LDA # 00 

STA-PAD 

RTS 

label 28: KEYIN 
LDA-PAD 

AND #0F 

EOR #@F 

RTS 

label 29: DELAY 

LDY #FF 

label 30: DELA 

DEY 

BNE to DELA (label 3@) 
RTS 

label 31: EQUAL 

NOP 

NOP 

NOP 

NOP 

NOP 

RTS 


Now that the INPUT program, including all its subroutines, has been 
entered into the Junior Computer, a check can be carried out to ensure 


that there were no errors during entry: 


key. 


SEARCH F F 1 @ 


SKIP 
SKIP 
SKIP 
SKIP 


display: 
FF 10 00 
78 

D8 

AQ 20 


8D 7E 1A 


comments: 
INPUT begins at label 10 
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When we are certain that everything has been entered correctly we can 
assemble the INPUT program. This can be carried out quite simply by 
pressing the ST key. The next task is to enter the interrupt routine |ROIN 
(figure 17a) and the look-up table DEL (figure 10). When entering the 
interrupt routine the editor must be used, but this routine is not to be 
assembled! ! 


key: display: comments: 

AD @OE2Q2 @GE2 xx 

DA 26 O@E2 7 

+ 1A 00E3 then 12 |: T38ibyies 
+ 79 OGE4 PiA-RAM 
AD 1CB5 1CB5 start address of editor 

GO 77 editor running 

INSERT 48 48 PHA 

INPUT E6DE E6 DE iNCZ-LENGTH 

INPUT AQ FF AY FF LDA #FF 

INPUT 8DFE1A 8D FE 1A STA-CNTG 

INPUT 68 68 PLA 

INPUT 490 40 RTI 

RST 


That takes care of the interrupt routine, and as for the look-up table: 


key: display: 
AD AQ® 1AQ@ xx 
1A@@ 8E 
1A@1 86 
1AQ@2 7E 
1AQ3 77 
1AQ4 7@ 
1A@5 GA 
1AG6 64 
1AQ7 5E 
1A@8 59 
1A69 54 
1AQA 4E 
1AQB 4A 
1AQC 47 
1A@D 43 
TAGE 3E 
1AQF 3C 


\) 
> 


1 
8 
8 
7 
7 
7 
6 
6 
5 
5 
5 
4 
4 
4 
4 
3 
3 


t++etteeeeeteeeree tet 
OmMwnrnpmshomeaponmoanm 


Now that everything has been entered, the program can be started: 


key: display: comments: 
AD @200 620078 INPUT program start address 
GO 


The INPUT program can be left in one of three (preferred) ways: 
by depressing the RST key 
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by filling the entire available melody memory with data; the processor 
will then jump to the monitor program 
* by depressing the ST key. In this instance the NMI vector will have to 
point to the start address of the following REPEAT program (0009). 
This means that once a melody has been entered, it can be played back as 
often as required by pressing the ST key. 
Warning! The Junior Computer should not be switched off after entering 
the INPUT program, as the REPEAT program is still to be entered. 
Although INPUT and REPEAT are two entirely separate programs, the 
one is not much use without the other. 


The REPEAT program 


The REPEAT program is capable of reproducing the melody entered into 
the memory during the INPUT program. In other words, the Junior 
Computer is capable of repeating performances to perfection!! The fol- 
lowing requirements must be met for the computer to be able to replay a 
stored melody: 
1. The computer is to convert the value of the key stored in memory into 
a note. During this process it will make use of the look-up table DEL. 
2. Immediately following the key value of each note in the melody 
memory is the code for the length of time the note was held. With the 
_ aid of an interrupt routine, this value wil! have to be converted back into a 
definite time period. For this operation the interval timer will be in the 
interrupt mode. 
3. To prevent the notes from ‘running into’ each other a short interval 
should be inserted between each note. The Junior Computer uses the 
interval timer to obtain this pause without any outside help. The interval 
timer will be operating in the polling mode for this operation. 
4. As soon as the entire melody has been replayed, the computer should 
jump back to the monitor program. 
The flowchart for the REPEAT program is given in figure 14. As it is very 
similar to the INPUT program in many ways it can be summarized very 
briefly. 
To start with, the processor is again inhibited from acknowledging an 
interrupt request. The IRQ vector is then set to point at the start address 
of the interrupt routine. In this instance it points to address location 
1A3@ (for the INPUT program it pointed to address location 1A2@) so 
that both programs can be run independently. 
Since the loudspeaker interface is connected to port line PB@, this line 
must be programmed as an output. The NOTE pointer must also be set, 
initially it points to address focation 0100, where the first key value of 
the melody to be repeated is stored. The next instruction (STA-CNTA) 
simply clears the timer interrupt flag and resets the interrupt request 
line. This is just a safety precaution and ensures that the 1RQ line will not 
be low when the next instruction is executed (CLI = clear interrupt flag = 
enable interrupt request) which will enable the CPU to accept interrupt 
requests. 
Now the microprocessor will have arrived at label FETCH. This is where 
the interval timer is started. The initial value of the programmable register 
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KEY $OODA 


disable interrupts 






























: : NOTEL *  $@@DC 
binary arithmetic NOTEH * $#@DD 
ieegedets LENGTH *  $@DE 
TA7E | startaddress DEL * $tA0d 
r none ae 
— 1a7e | (A390) IRORE * $1A30 
AS} LDA #91 RESET * $1C1D 
8D 1A83 = PB = output - RDFLAG * $1AD5 
so| STA—PBD |1A82 PBI =1 CNTA * —STAFA 
85 DD 91~>NOTEH cet od ae 
Ag \e=> a0 peo + Sta82 
85 Dc 00 >NOTEL PBDD * $1483 
= cL reset IRQ line 
enable interrupts 
DELAYS 
(7) DEL: 1AQ0 8E 
1A91 86 
1AG2 7E 
AQ start interval TAGS 7 
8D 1AFE timer 1464 76 
Aol LDY #60. 1AQ5 GA 
a1 DC load key value ees 
85 DA key value +KEY WAO?: (/2E 
ce V=v+1 ae 
B1 DC toad duration eee es 
85 DE duration» LENGTH eee ae 
Ad DA Y~+ key value eae 
1AGC 47 
1AGD 43 
80915-6-1338 1AGE 3E 
1AGF 3¢ 


Figure 18. The flowchart of the REPEAT program. This program enables the Junior 
Computer to replay a previously stored melody. It uses the same look-up table (DEL) 
as the INPUT program. 


is $ FF and the division factor is again 64, as during the INPUT program. 
By writing into the data register CNTG the interrupt request line of the 
PIA will be enabled. The interval timer will now operate independently of 
the main routine until it reaches a time out (1632@ us). The computer 
therefore has plenty of time (relatively speaking!) to fetch the key value 
and the length of time the key was depressed from memory. The key value 
is then converted into a frequency with the aid of the look-up table DEL. 
This occurs at label TONE. | 
The loudspeaker is switched on and off at labels TONEA and TONEB 
respectively. The loop times during this process should be exactly 27 us 
as during the INPUT program. For this reason two delay loops are required 
instead of just the one for the INPUT program: EQUALA provides a delay 
of 22 us and EQUALB provides a delay of 17 ps. 

The computer will continue to produce a tone until the interval timer 
reaches a time out and causes an interrupt request. The processor will then 
branch to the interrupt routine at address location 1A3@ (the IRQ vector 
was set to this location at the start of the program). This interrupt routine 
performs the exact opposite operation of that in the previous program: 
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TONE (2) 


aol Loa #60 


8D STA —PBD | 1A82 PBd=¢ 


BE | LOX - | LOX ~— DEL.Y | | LOX — DEL,Y| 1A00 fetch delay 


C™ )® 


aeons: 


x«+X—-1 


~ (3) x=@ 
yes 


Ag] LOA #91 
sD STA — PBO 1A82 PB¢=1 
BET LDX —DEL,Y] 1A@¢ fetch delay 


Cm )@ 


AS} Loaz-cenatu | | LDAZ—LENGTH | LENGTH A<-LENGTH 


~<me> 9 yes _, duration over? 


20 ([cauars [](%) | wait 17s 


cal eK xox =1 


TONEC (is) 


A2|_LOx #04 | x06 


TONED 


LOA #3¢ 
8D| STA —CNTD | 1AF7 start interval timer 


POLL @) 


2CIBIT —RDFLAG| 1405 






yes 


£6 | incz -NoTet | DC 
66 Diwwcz nove. | oc f NOTE “NOTE +2 


AG LOY #@ 
1 [asm] oc Te 


cg CMP #77 


z<2 (11) is there another note to follow? 


JMP — RESET 


80915-6-18b 
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EQUALA 22 us 
[vor 
4c] JmMP —EQUALB 1A36 
ecue @) 17 af pHa 
C6 DEC — LENGTH GGDE 
: 
EA 8D STA —CNTG 1AFE 
a¢ RTI 





80915-6-19b 


6¢ 


80915-6-19a 


Figure 19. The subroutines EQUALA and EQUALB (a) are required by the REPEAT 
program to ensure that the frequencies of the replayed notes are exactly the same as 
‘the previously ‘recorded’ ones. The interrupt routine IRORE (b) determines the 
length of time the note is to be played. 


this time the contents of location LENGTH are decremented by one. 
During the REPEAT program therefore, the processor produces a note 
(from label TONE) until the contents of LENGTH become negative, as a 
result of several interval timer interrupts. 

When this situation occurs, the program will branch to label TONEC. 
Before the next note is fetched from the melody memory and played, the 
computer must insert a short interval so that the individual notes do not 
‘run’ into each other. To achieve this the interval timer wili have to be 
used once more, this time in the polling mode. At label TONED the 
interval timer is prevented from causing a further interrupt request. The 
instructions LDA #3@ and STA-CNTD start the interval timer in the 
polling mode, reset the interrupt flag in the interrupt flag register and set 
the division factor to 1924. By using data register CNTD the interval timer 
is unable to cause an interrupt request after the time out. 

Once the interval timer has been started, the processor will remain in the 
delay loop POLL-BPL-POLL until the timer interrupt flag is set (after 
4 x (48 x 1024) + 1) = 196,612 us). This procedure is repeated four times, 
as the X register is decremented by one after each time out. This means 
that the total time spent in the delay loop is increased by a factor of four 
to give a total delay in the region of 0.2 seconds. After this time the 
computer increments the NOTE pointer by two so that it points to the 
location of the next note to be fetched and played. Before fetching this 
note however, the processor tests to see whether or not the NOTE pointer 
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has already arrived at the end of the melody. This can be detected by the 
presence of the dummy character 77. Once all the notes stored in the 
melody memory have been played, the Junior Computer will return to the 
monitor program. 
Shown below are the steps involved in order to enter the REPEAT 
program from the hexadecimal keyboard (mustn‘t get confused must 
well). It should now be fairly easy to assemble the program on page @ 
(start address 0000), all the steps involved have been covered thoroughly. 
Finally, a well known melody has been provided for readers who may 
suffer from tone-deafness — have fun with it... 


key: 
AD 
DA 
+ 

+ 

+ 
AD 
DA 
+ 
AD 
GO 


INSERT 


INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 


Tt 
No 


-- oO - ome e @& 
~! 
> 


Oon-pseesesese 


0 
o1 


FF19000 
78 

D8 
A930 
8D7E1A 
AQITA 
BDTJFIA 
A901 
8D831A 
BDB21A 
85 DD 
A900 
85 DC 
8DF41A 
58 
FF110@ 
AQ FF 
8SDFETA 
AQOOO 
B1DC 
85 DA 
C8 
B1DC 
85 DE 
A4DA 
FF12090 
AQ9@G@O 
8D821A 


display : 
GQE2 xx 
QOGE2 00 
QGE3 40 
QOE4 EO 
@0E5 06 
1A7A XX 
1A7A 51 \ 
1A7B 1F 
1CB5 20 
77 

FF 10 00 
78 

D8 

AQ 30 

8D 7E 1A 
AQ 1A 

8D 7F 1A 
AQ 61 

8D 83 1A 
8D 82 1A 
85 DD 
AYO 00 

85 DC 
8D F4 1A 
58 

FF 11 60 
AY FF 

8D FE 1A 
A® 00 

B1 DC 
85 DA 
C8 

Bt DC 
85 DE 
A4 DA 
FF 12 60 
AQ G6 

8D 82 1A 


comments: 
0000 
Qed 


NMl-vector = 1F51 
(start assembler with ST) 


start address of editor 
editor running 
label 10: REPEAT 
SEI 

CLD 

LDA #30 
STA-IRQL 

LDA #1A 
STA-IRQH 

LDA #61 
STA-PBDD 
STA-PBD 
STAZ-NOTEH 
LDA #00 
STAZ-NOTEL 
STA-CNTA 

CLI 

label 11: FETCH 
LDA #FF 
STA-CNTG 

LDY #60 
LDA-(NOTEL),Y 
STAZ-KEY 

INY 
LOA-(NOTEL),Y 
STA-LENGTH 
LDYZ-KEY 

label 12: TONE 
LDA #06 
STA-PBD 
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INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 
INPUT 


BE®@O1A 
FF1300 
201800 
CA 
DQi13 
AQ9@1 
8D821A 
BE@O1A 
FF1400 
A5DE 
3015 
2019090 
CA 
DQO14 
F@12 
FF150@0 
A204 
FF1600 
A930 
8DF71A 
FF170@ 
2CD51A 
1017 
CA 
D@O16 
E6DC 
E6DC 
A@O@ 
B1DC 
C977 
DO11 
4C1D1C 
FFI860 
EA 
4cC1900 
FF1960 
EA 
4C20090 
FF2066 
6 0 


BE 00 
FF 13 
20 18 
CA 

DO 13 
AQ 01 
8D 82 
BE 00 
FF 14 
A5 DE 
30 15 
20 19 
CA 

Do 14 
FO 12 
FF 15 
A2 04 
FF 16 
AQ 30 
8D F7 
FF 17 
2C D5 
10 17 
CA 

DO 16 
E6 DC 
E6 DC 
Ad G0 
B1 DC 
C9 77 
DO 11 
4C 1D 
FF 18 
EA 

4c 19 
FF 19 
EA 

4C 20 
FF 20 
60 


1A 


60 


TA 
1A 
00 


00 
0@ 
1A 


00 
1A 


1C 
00 


00 
00 


00 
00 


LDX-DEL,Y 
label 13: TONEA 
JSR-EQUALA (label 18) 
DEX 

BNE to TONEA (label 13) 
LDA #61 

STA-PBD 

LDX-DEL,Y 

label 14: TONEB 
LDAZ-LENGTH 

BMI to label TONEC (label 15) 
JSR-EQUALB (label 19) 
DEX 

BNE to TONEB (label 14) 
BEQ to TONE (label 12) 
label 15: TONEC 

LDX #04 
label 16: TONED 

LDA # 30 

STA-CNTD 

label 17: POLL 
BIT-RDFLAG 

BPL to POLL (label 17) 
DEX 

BNE to TONED (label 16) 
INCZ-NOTEL 
INCZ-NOTEL 

LDY #0@ 
LDA-(NOTEL}),Y 

CMP #77 

BNE to FETCH (label 11) 
JMP-RESET (monitor; RESET = 1C1D) 
label 18: subroutine EQUALA 
NOP 

JMP-EQUALB (label 19) 
label 19: EQUALB 

NOP 

JMP-EEND (label! 20) 
label 26: EEND 

RTS 


Before assembling the program it should be verified: 


key: 


SEARCH F F 1 @ 


SKIP 
SKIP 
SKIP 
SKIP 
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display: 


FF 10 
78 
D8 
AQ 30 


8D 7E 1A 


The majority of the finger work is now complete. All that remains is to 
enter the interrupt program IROQRE. As with the previous interrupt 
routine, this routine must not be assembled: 


key: display: comments: 

AD @@E2 Q@GE2 XX 

DA 30 QGE2 30 

+ 1A Q0E3 1A sa 

+ 79 Q@0E4 79 

AD 1CB5 1CB5 20 start address of editor 

GO 77 editor running 

INSERT 48 48 PHA 

INPUT C&6&éDE C6 DE DECZ-LENGTH 

INPUT AQ FF AQ FF LDA # FF 

INPUT 8DFE1A 8D FE 1A STA-CNTG 

INPUT 68 68 PLA 

INPUT 44 46 RTi 

RST 

All that needs to be done now is play a tune. First we start the INPUT 
program: 

key: display: comments: 

AD 020G 0200 AQ start address of the INPUT program 
GO blank 


The display will remain blank until the processor returns to the monitor 
program. To enter a short melody: 


key: display: comments: 
924577999 blank as these keys are 
975555442 depressed, their value and 
222G duration are stored in the 


melody memory 


To replay the melody now that it has been entered: 


key: display: comments: 
AD G00 GG066 78 start address of the REPEAT program 
GO blank the display will remain blank until the 
entire melody has been repeated; 
0600 78 depressing the GO key will start the 


REPEAT program once more 


This brings us to the end of this chapter. We have discovered how to 
program the interval timer, the edge detector and the input/output ports 
of the peripheral interface adapter. We are even able to amaze our relatives 
and friends by playing musical (?) tunes on the computer. By the way, a 
source listing of all the programs mentioned in this chapter is given in the 
appendix at the back of this book. 

This chapter will serve as a useful reference when it comes to connecting 
peripheral devices such as printers, video terminals (elekterminal) etc. to 
the Junior Computer. Book II! will introduce a cassette interface for the 
system which will include the software required to store programs on (and 
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retrieve them from) standard audio cassettes. Again, the PIA will be used 
to control the tape recorder and to produce the FSK signal. The Junior 
Computer will then evolve into a real mini-computer and will be well on 
the way to becoming a complete personal computer which will be capable 
of understanding high level languages such as BASIC. However, before that 
point is reached, we must understand completely how all the routines 
contained in the monitor program, including the editor and the assembler, 
work and how they can be incorporated into user programs. 
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The Monitor program 
Basic ‘housekeeping’ software 


For the programmer to be able to communicate with the Junior 
Computer, the machine must be capable of receiving and trans- 
mitting information in a form that is understandable to both. 
The computer must be able to decode information entered from 
the keyboard and output the processed data to the display. 
Therefore, the computer needs to be programmed to recognise 
various input and output parameters. This is where the monitor 
software comes in. 

By monitor software is meant a program, usually stored in 
ROM (Read Only Memory), which provides the user with all 
the control functions required to operate the system satisfac- 
torily. A monitor program typically contains a number of 
(sub)routines which perform such chores as program loading, 
debugging and general ‘housekeeping’. 

The monitor program of the Junior Computer contains a large 
number of subroutines which, for instance, indicate address 
and data information on the display, decode the data and 
command keys and execute the particular command function 
encountered (AD, DA, +, PC and GO). One of the advantages of 
the monitor program is the fact that the programmer is able to 
Incorporate one or more of its subroutines into his/her own 
program without having to develop them first. 

Furthermore, the [RO and NMI vectors are stored in RAM, so 
they can be changed during the main program if required. 
This is essential if more than one interrupt routine is to be used 
with a single interrupt vector. All this (and more) will be 
discussed in the course of this chapter. 
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A review of the monitor 


The monitor program of the Junior Computer is stored in EPROM. In 
computer jargon such a program is a ‘resident’, insomuch as it is perma- 
nently available — as soon as the power supply is turned on. The monitor 
program requires a few memory locations in page zero to be kept ‘free’ for 
its own use. These locations contain data which the computer must refer 
to frequently and (if necessary) update in order to carry out certain 
tasks. You may recall from Book 1 that many programs ended with the 
break (BRK) instruction. When the computer encountered this instruction 
the contents of the internal CPU registers were stored in page zero. This 
was so that the programmer could examine these registers before the 
Junior Computer returned to the monitor program and altered their 
contents. 

Basically, the Junior Computer monitor program can be compared to a 
delay loop. When the computer is in this loop, it periodically scans the 
keyboard (waiting for a key to be depressed) and the contents of the three 
display buffers (POINTH, POINTL and INH) are multiplexed to the 
display. 

If the programmer presses one of the five command keys, the computer 
will perform the operations corresponding to these keys. If, for example, 
the AD key was depressed, the computer will interpret the next data entry 
(keys @...6) as being an address. If the DA key was depressed, the fol- 
lowing data will be stored in the address location shown on the display. 
You should be totally familiar with the functions of the other command 
keys from Book 1. 

There are a number of ways in which to ‘jump’ to and from the monitor 
program: 


1. Jumping to the monitor program 
* Via the RST key: the Junior Computer will then jump into the monitor 
program and will immediately initialise the two input/output ports of 
the peripheral interface adapter. After this the computer will wait in a 
‘loop’ until a key is depressed. The Junior Computer may now be ‘spoken 
to’ via the command keys AD, DA, +, PC and GO by the data keys @...F. 
* Via a non-maskable interrupt: the monitor program may also be ac- 
cessed via the NMI vector. If the NMI vector is set to point at address 
location 1C@@, the computer will save the contents of the internal CPU 
registers. The computer will then enter a loop where it once again scans 
the keyboard and the display. Again, it will wait until one of the above 
mentioned keys is depressed. The PIA will not be initialised if the NMI 
vector is pointing to address location 1C@@. 
Via an interrupt request: the monitor program may also be entered via 
the {RQ vector. This is, however, only possible when the interrupt flag 
in the status register of the CPU is reset (CLI). If the IRQ vector is 
pointing to address location 1CQQ, the situation will be identical to that of 
the NMI vector above. 
* Via the BRK instruction: as we know from Book 1, the BRK instruc- 
tion utilises the [RO vector. If this instruction is to be used to enter the 
monitor program, the 1RO vector must be pointing to address location 
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1C@0. The Junior Computer will then store the contents of the internal 
CPU registers and will enter a loop as in the cases of RST, NMI and IRQ. 
“ Via the JSR instruction: the programmer is able to incorporate the 
subroutines of the monitor program into his/her own program. The 
RTS instruction at the end of each subroutine ensures that the processor 
will return to the user program upon completion of the subroutine. 
“ Via the JMP instruction: the programmer may include a ‘jump to 
monitor’ instruction at the end of his/her program. By doing this the 
Junior Computer display will light when the end of a user program is 
reached as an indication to the programmer that the processor has com- 
pleted the allotted task. If a JMP instruction is to be used to enter the 
monitor program, the jump should always lead to address location 1C1D 
(JMP-1C1D or 4C 1D 1C)). Jumping to this address will initiate a reset 
sequence and the PIA will again be programmed to scan the keyboard and 
display. Here too the Junior Computer will wait in a loop until a key is 
operated. 


2. Jumping from the monitor program 
* Via the GO key: the most common method of leaving the monitor pro- 
gram is to depress the GO key. After this the processor will start oper- 
ating from the address shown on the display. The display will then go 
blank. 
“Via a non-maskable interrupt: the processor can also leave the monitor 
program by means of the NMI vector. If the interrupt routine concludes 
with an RTI instruction, the monitor program will be returned to upon 
completion of the routine. If, however, there is no return to the monitor 
program, the input/output lines of the PIA should al! be programmed as 
outputs immediately after leaving the monitor program to ensure that the 
display does not light inadvertently. This can be accomplished quite 
simply via the following program sequence: 
(PHA) (save accumulator contents) 
LDA 00 
STA-PBD all display cathodes are ‘off’ 
STA-PAD all display segments are ‘off’ 
(PLA) (restore previous accumulator contents) 
It should be noted that the contents of the accumulator need only be 
saved if the accumulator is to be used by the interrupt routine. This is why 
the instructions PHA and PLA are shown in parentheses. 
Via an interrupt request: the processor can also leave the monitor pro- 
gram by means of the IRQ vector, provided that the interrupt flag in 
the CPU status register is reset. The situation will then be the same as that 
for the non-maskable interrupt. 
As a reminder, the NMI and IRQ vectors are stored in page 1A of the 
Junior Computer memory. They have been allocated the following address 
locations: 
NMIL: $ 1A7A 
NMIH:$ 1A7B 
IROL: $ 1A7E 
IRQH: $ 1A7F 
The contents of the above memory locations determine where the pro- 
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cessor branches to after an }RO, NMI or BRK instruction. Both interrupt 
vectors can be set either manually or by the program itself. 

So far we have been recapping on chapter 3 of Book 1 to make sure that 
you will fully understand the following section. 


The basic flowchart of the monitor program 


The basic flowchart of the monitor program is shown in figure 1. It is 
composed of the usual flowchart symbols. The monitor includes three 
inputs and two outputs. The flowchart does not, however, allow for the 
monitor to be exited after an interrupt. 












store all 
program 
data 





(re)initialise 







1033... .1044 
JSR 














display address 
and corresponding 

data; place key 

value in 
accumulator 







various 
monitor 
subroutines 









user’s 
program RTS 


1045 ...1C48 





1c5C ...1CB4 









restore 
previously 
saved data 


execute 
routine{s} 

pertaining to 

depressed key 










SCAND 1D&8s ....1DCB 
SHOW 1pcc ...1DDE 
CONVD 1DDF ...1DF8 
GETKEY 1DF9...1E1F 

Lookup table 1FQOF... 











Figure 1. The basic flowchart of the Junior Computer monitor program. The various 
entry and exit points are clearly indicated (1... 5). The address locations shown in 
the figure correspond to those given in the program listing at the back of this book. 
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The ins and outs of the monitor program 
Input © leads to the label RESET. The CPU wil! enter the monitor 
program at this point if the RST key is depressed. The RESET label can be 
found at address location 1C1D. From this point on the processor will 
initiate the PIA and reset the stack pointer. The CPU status register is also 
preset — exactly how will be discussed later. What is important to know at 
this stage is that between the labels RESET and START the Junior Com- 
puter is programmed to control the display and scan the keyboard. tn 
addition, the computer will operate in the binary mode (CLD) and the 
interrupt flag in the status register will be set. The Junior Computer will 
therefore not acknowledge any interrupt requests. 

Summary: There are various methods of entering the monitor program via 

input @: 

— by depressing the RST key 

— by means of a JMP instruction: JMP-1C1D 

— via a non-maskabie interrupt: the NMI vector points to address location 
1C1D. 

—~ via an interrupt request (if the interrupt flag is reset): again, the IRO 
vector should point to address location 1C1D. 

— via the BRK instruction: the BRK instruction utilises the IRO vector, 
lf this instruction is to be used to jump to the monitor program, the 
1RQ vector must point to address location 1C1D. 

Input @ will lead to the label SAVE. This routine starts at address location 

1C@@. Between the two labels SAVE and START, the contents of the 

internal CPU registers are stored in page zero at the following address 
locations: 

PCL at address location @@EF 

PCH at address location @OFQ@ 

status register at address location OOF 1 

user stack pointer at address location @O@F2 

accumulator at address location 00F3 

Y register at address location 0@F4 

X register at address location OOF5 

Warning!! The monitor program should only be entered via input @ with 

the aid of one of the interrupt vectors. Only then can the CPU registers 

PCH, PCL and the status register be saved in the correct manner. 

The stack pointer will then also be pointing to the correct address location 

as if the monitor program had been left via the GO key. Note: !f the user 

program alters the contents of either of the PIA data direction registers, 
the input/output lines will not be re-initialised immediately! 

Summary: There are various methods of entering the monitor program via 

input @. 

— by depressing the ST key: this causes a non-maskable interrupt. The 
NMI vector must therefore be pointing to address location 1C@@. The 
NMI vector is stored at locations 1A7A and 1A7B. 

— via the STEP mode: this also uses the NMI vector. Many of the pro- 
grams given in Book? were run in the STEP mode. In this mode 

the individual program instructions will be executed one after the other 

each time the STEP key is operated. The processor will carry out the 
instruction being shown on the display and will then save the contents of 
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all the CPU registers in page zero. The next instruction will then appear on 
the display. Before the Junior Computer can operate in the STEP mode, 
the NMI vector must be pointing to address location 1CQ@@ (label SAVE). 
This step-by-step procedure will be dealt with in greater detail later on. 
— via a non-maskable interrupt caused by a peripheral device (such as a 
printer): here too the NMI vector must point to address location 1CQ9. 
— via an interrupt request (as long as the interrupt flag in the status regis- 
ter is reset — 1 = @): in this instance the IRQ vector must be pointing to 
the start of the SAVE routine (1A7F = 1C, 1A7E = 0). 
— not via the BRK instruction: the BRK instruction should not be used to 
jump repeatedly into the monitor program via input @. Just to be on 
the safe side, we should never branch to the monitor program via a BRK 
instruction and input @ as this could easily cause the wrong program coun- 
ter value to be stored on the stack (PC + 2) and the stack itself to exceed 
its limits. 
Input @ leads to various subroutines contained in the monitor program. 
The operator may incorporate these into his/her own programs by calling 
them up with a jump-to-subroutine (JSR) instruction. Each of the sub- 
routines ends with instruction RTS (return-from-subroutine) to ensure 
that the processor always returns to the user’s main program (output ©). 
This brings us up to date on all the tasks which the Junior Computer per- 
forms between the labels RESET and START and between the labels 
SAVE and START. From the START label onwards the Junior Computer 
enters a loop which can only be exited by operating the GO key. 
Once in the loop the computer will call up various monitor subroutines 
and scan the keyboard and display. If a key is depressed, the processor will 
check to see whether it was the GO key. If it wasn’t, the Junior Computer 
will remain in the loop. If a command key was depressed, the particular 
command will be carried out; if a data key was depressed the value of the 
key will appear either in the address or data section of the display (de- 
pending on which command key was depressed previously). The same 
procedure will then begin all over again at label START. 
lf some time during the loop the GO key is depressed, the processor will 
exit from the monitor program via the RTI (return-from-interrupt) instruc- 
tion. In other words, the monitor program would normally be left via 
output ©, 


The STEP mode 

Any discussion of the monitor program must of course include a word or 
two on the STEP mode. In this mode the hardware and the software of 
the Junior Computer work ‘hand in glove’. To fully understand this mode 
of operation we will refer to the circuit diagram of the Junior Computer 
which was given in chapter 1 of Book 1 (figure 4). This shows that pin 7 
of the microprocessor (IC1) is connected to one input of the NAND 
gate NS. The other input to this gate is connected to the chip select 
signal K7. The output of the gate, when switch S24 is closed, is connected 
to the non-maskabie interrupt line of the microprocessor. When the Junior 
Computer is operated in the STEP mode the LED (D2) above the STEP/ 
GO key will be lit. 

An address location containing an instruction will now be shown on the 
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display. If the programmer wishes to execute that particular instruction 
all he/she needs to do is depress the STEP key. The processor will then 
leave the monitor program via output @ and start operating from the 
address shown by fetching the instruction from memory. While the com- 
puter is fetching the instruction, the SYNC output of the microprocessor 
(pin 7) will go high. At this time the EPROM (IC2) is not being accessed 
therefore the CS fine (K7) will also be high. This means that the output of 
N5 will go low to cause a non-maskable interrupt. The processor therefore 
executes the instruction currently shown on the display and then services 
the interrupt. The computer will then jump to address location 1C0@ 
(label SAVE) via the NMI vector. 

The processor will now have entered the monitor program once more. 
This means that the EPROM will be addressed and line K7 will be low. No 
further NMI will occur as the output of N5 will now be high. 

During the SAVE routine the contents of all the internal CPU registers are 
stored in page zero and the program counter is loaded with the address 
location of the next instruction to be executed. The new contents of the 
program counter are then loaded into the display buffers POINTH and 
POINTL. After the START routine the computer will display the next 
instruction and its corresponding address. \f the STEP key is then pressed 
once more the complete procedure described above will be repeated. 


The interrupt vectors and the BRK instruction 


Up to now we have only been interested in where to store the NMI and 
(RO vectors so that the CPU is able to service an interrupt. Now it is time 
to find out exactly how the processor fetches these interrupt vectors 
from memory locations 1A7A, 1A7B and 1A7E, 1A7F. The complete 
procedure is shown in detail in figure 2. The memory map to the left of 
the diagram can be split into two sections. The upper section consists of 
RAM locations, where the operator’s program is stored. As you know, this 
is made up of pages @, 1, 2, 3 and the 1/8 k of RAM in the PIA (page 1A). 
The lower section is where the monitor program is stored in the EPROM. 
To clarify the interrupt procedure in the Junior Computer and to keep the 
diagram as simple as possible only the most important locations have been 
selected. All the various possibilities of how to jump into and exit from 
the monitor program are given to the right of figure 2. By monitor pro- 
gram we mean the section contained in the EPROM that we dealt with in 
Book 1 and the six memory locations for the NMI, reset and IRO vectors 
at addresses 1FFA...1FFF. The following points provide all the 
necessary information about these vectors: 

1. The RST key 

When the RST key is depressed the processor examines the contents of 
address locations 1FFC and 1FFD to obtain the reset vector. These 
locations permanently point to address 1C1D (they are stored in the 
EPROM). The processor will therefore branch to the RESET label shown 
in figure 1 (output ©). This same label can however also be accessed by 
jumping from the user’s main program via a JMP instruction. 

2. Non-maskable interrupt 

As far as the Junior Computer is concerned, a non-maskable interrupt can 
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Figure 2. Diagrammatic representation of the interrupt procedure of the monitor 
program. The points marked 1, 2, 4 and 5 correspond to those given in figure 1. 
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be initiated in three different ways: 

by depressing the ST key 

by a peripheral device connected to the NMI fine of the control bus. 
This line is fed to the external world via the expansion connector. 

by the output of NS going low when the computer is in the STEP 
mode. 

Whenever the NMI input tine of the microprocessor is taken low (no 
matter how), the computer will perform a set procedure (see figure 2). 

The processor will acknowledge the interrupt upon completion of the 
current instruction’s execution. Following the interrupt acknowledge, the 
processor disables further interrupts by setting the interrupt flag in the 
status register. The CPU then pushes the contents of all the internal regis- 
ters onto the stack (page zero). The program counter is then loaded with 
the NMI vector which will be fetched from memory locations 1FFA and 
1FFB. In the case of the Junior Computer, this vector points to address 
location 1F2F. The processor will therefore jump to this address and carry 
out the instruction it finds there, which is an indirect jump instruction. 
As we know from Book 1, an indirect jump causes the processor to obtain 
the absolute address from the contents of the indirect address location. 
As the instruction at locations 1F2F ...1F31 is 6C 7A 1A (jump indirect 
to address location 1A7A), the processor will effect a jump to the address 
contained at locations 1A7A and 1A7B and from there will start the 
interrupt routine. 

Figure 2 shows that locations 1A7A and 1A7B contain @@ and 1C respec- 
tively. This means that the Junior Computer will service the interrupt 
from location 1C@@, which, as we know, is the address of the SAVE 
routine in the monitor program (input @). As address locations 1A7A and 
1A7B are in fact RAM locations, the interrupt vector can point to any 
address (not necessarily in the monitor program). 

3. Interrupt request 

Before the processor can acknowledge an interrupt request, the interrupt 
flag in the status register will have to be reset (CL!). An interrupt request 
can be initiated in four different ways in the Junior Computer: 

by a peripheral device connected to the |IRQ line of the contro! bus. 
This line is fed to the external world via the expansion connector. 

by means of an interval timer IRQ 
by means of an edge detector IRO 
by the BRK instruction 
Whenever the IRQ input line of the microprocessor is taken low (provided 
the interrupt flag is reset), the computer will perform a set procedure. The 
programmer however, must ensure that the interrupt request line is reset 
before returning from the interrupt routine, so that the processor is unable 
to service the same interrupt request more than once (see chapter 6). 
Figure 2 again illustrates the various steps taken during the IRQ 
procedure. 

The processor will acknowledge the interrupt request upon completion of 
the current instruction’s execution. Following the interrupt acknowledge, 
the processor disables further interrupt requests by setting the interrupt 
flag in the CPU status register. The CPU then pushes the contents of all 
the internal registers onto the stack (page zero). The program counter is 


% 


(see chapter 6) 


* 
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then loaded with the IRQ vector which will be fetched from memory 
locations 1FFE and 1FFF. 

In the case of the Junior Computer, this vector points to address location 
1F32. The processor will therefore jump to this address and carry out the 
instruction it finds there, which is an indirect jump instruction. As the 
instruction at locations 1F32...1F34 is 6C 7E 1A (jump indirect to 
address location 1A7E), the processor will effect a jump to the address 
contained at locations 1A7E and 1A7F and from there will start the 
interrupt request routine. 

Figure 2 shows that locations 1A7E and 1A7F contain @@ and 1C respec- 
tively. This means that the Junior Computer will once again jump to the 
start of the SAVE routine (input @). As before, the !ROQ vector can point 
to any (addressable) location. 

4. The BRK instruction 

Although the BRK instruction was used in many of the program examples 
given in Book 1, this useful instruction was not fully described. All the 
more reason to do so now: 

Imagine that the processor is manipulating a program which the operator 
has entered into the computer. At the end of the program the processor 
encounters a BRK instruction (op-code 00). As we know, the BRK instruc- 
tion utilises the |RQ vector, that is to say, the following procedure will be 
exactly the same as that for an interrupt request (see point 3). Before 
fetching the 1RO vector, the B flag in the status register is set and the 
contents of the internal registers are pushed onto the stack. Note that in 
this instance the low order byte of the program counter is incremented 
twice before being stored on the stack. This means that if, for example, 
the BRK instruction was located at address 022A, the saved value of the 
program counter will be @22C not @22B! Therefore extreme care must be 
taken when using this instruction. 

One advantage however, is that the BRK instruction can be used to ‘debug’ 
a suspect program (section). When the operator decides that a particular 
program is not functioning correctly, the BRK instruction can be used to 
overwrite the first byte of an existing instruction. The program under test 
will then operate normally up to this point, where the processor will 
branch to the address location pointed to by the IRQ vector. As the 
(absolute) |RQ vector is stored in RAM, the BRK instruction can be used 
to jump to any part of addressable memory. !n figure 2 the |RQ vector 
(contents of locations 1FFE and 1FFF) is pointing to address location 
1F32. The computer will therefore execute the indirect jump instruc- 
tion it finds there and will continue operation from location 1C@@ (start 
of the monitor program). 

5. The interrupt flag versus the break flag 

When the processor acknowledges an interrupt it automatically sets the 
interrupt flag in the status register. When executing a BRK instruction it 
automatically sets the break flag in the status register. 

Why the need for these flags? Simple. Both the interrupt request and the 
BRK instruction utilise the [RQ vector. If there were no flags there would 
be no way to determine which of the two operations caused the interrupt 
in the first place. If, for example, several visual display units are connected 
to a central computer and are operated via the two interrupt lines (NMI 


100 


and IRQ), several interrupt routines would have to be nested. If the 
interval timer is also being used, the number of possible nested interrupt 
routines would increase even more. As the Junior Computer has 16 input/ 
output lines it is theoretically possible to connect as many as 16 peripheral 
devices to these lines simultaneously. To detect whether an interrupt was 
caused by hardware or software, the status register can be examined to 
check whether or not the break flag is set. This can be done quite simply 
by including the following series of instructions at the start of the initia! 
interrupt routine: 


PLA load contents of status register 

PHA restore onto stack 

AND 19 mask break flag 

BNE branch to break routine if set 
: continue if not 


This interrupt routine could then determine which of the peripheral 
devices was responsible for the interrupt (presuming of course that it was 
not the BRK instruction). 

An important difference between the interrupt flag and the break flag is 
that the interrupt flag can be set or reset during a program, but there are 
no instructions to set or reset the break flag. The latter is set when a BRK 
instruction is encountered and is only reset when the interrupt flag is set 
following an interrupt request. 


Using the BRK instruction for debugging 


When debugging a program, it is quite feasible that the operator frequently 
needs to utilise the BRK instruction to branch to an interrupt. This can be 
compared to the jump-to-subroutine (JSR) instruction, but in this instance 
the tota! instruction length is shortened to one byte (instead of three). For 
this reason, the value for the program counter contained on the stack will 
correspond to the address location two bytes higher than that immediately 
following the BRK instruction. This does not usually cause any problems 
during the debugging as, once the interrupt routine has been completed, 
the processor will return to the main program to carry out the instruction 
following the one which was ‘patched’ over by the BRK instruction, pro- 
vided it is a two-byte Instruction. 


old code $236 LDA (AD) 
0237 3F 
Q238 01 


$239 next opcode 


patched code @236 BRK (@@) 
9237 NOP (EA) 
0238 NOP (EA) 
@239 next opcode 
Thus the following analogies can be made between the JSR and BRK 
instructions: 
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jump to subroutine (absolute) starting at 
address location XXYY 


execute subroutine 


return to main program 





BRK jump to interrupt routine pointed to by the contents of the {RQ vector 
after saving the value of the program counter (+2) and the contents of 
the status register on the stack 

vy (first memory location after the one containing BRK) 

XX (second location) 


start address of interrupt routine 


RT| 


execute interrupt routine 


return to main program 


if, however, the operator wishes the computer to continue main program 
execution from the address location immediately following the BRK in- 
struction, the value of the program counter will have to be altered before 
the return-from-interrupt instruction is encountered. This can be ac- 
complished by including the following program section: 
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PLA fetch status from stack 
STA-MEM into MEM 

PLA fetch low order PC (PCL) 
STA-MEM+1 into MEM+1 

PLA fetch high order PC (PCH) 
STA-MEM+2 into MEM+2 

SEC set carry 

LDA-MEM+1 subtract one from PCL 
SBC # @1 

STA-MEM+1 

LDA-MEM+2 — subtract one from PCH 
SBC # 00 if corrected PCL = FF 
PHA corrected PCH back to stack 
LDA-MEM+1 corrected PCL via A 

PHA back to stack 

LDA-MEM status via A 

PHA back to stack 

RTi return to main program 


It may well transpire that the contents of the status register are altered 
during the course of the interrupt routine. If the operator wishes to use 
this new information in the main program — provided the old status 
register is not required — the above sequence can be modified so that only 
the new contents of the status registers are saved: 


BRK jump to interrupt routine pointed to by the contents of the !RQ vector 
after saving the value of the program counter (+2) and the contents of 
the status register on the stack 


start address of the interrupt routine 


. execute interrupt routine 

the interrupt routine has been completed and the processor should now 
jump back to the main program. The new status register information is 
required in the main program and will! therefore have to be saved. 


PLA adjust the stack pointer, in order to 
PHP replace the old status with the new one 
(continue with the program on p. 102) 


The new contents of the status register can now be examined by the 
Operator during the execution of the main program. 

This concludes the description of all the inputs and outputs of the monitor 
program. The rough flow chart (figure 1), the BRK instruction and the 
interrupts have all been explained in detail. The BRK instruction and the 
interrupt structure of the 6502 microprocessor enable programs to be 
tested and corrected both quickly and efficiently, even though the pro- 
grams are getting longer and longer! The next step is to examine the 
monitor program in greater detai! — instruction by instruction. 


The monitor program 


As can be seen from figure 1, the monitor program contains three major 
routines: RESET, SAVE and START. These routines can be evaluated by 
examining each instruction in turn. The flow charts and diagrams of the 
monitor program enable the beginner to understand just how the Junior 
Computer operates. There is, of course, another reason for describing the 
monitor program in detail: by studying the fiow charts etc. the newcomer 
can assimilate his/her thought processes with those of professional pro- 
grammers. This educational aspect should be borne in mind when reading 
the following passages. 
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RESET 


Before the Junior Computer is able to communicate with the operator, via 
the keyboard and display, it needs to be brought into a certain initial 
condition. This is carried out by means of the RST key. As we already 
know from chapter 6, the peripheral interface adapter first has to be 
programmed to provide the correct input and output tines for the key- 
board and display. Internal CPU registers, such as the stack pointer and the 
status register also have to be initialised. 

When the RST key is depressed the CPU ‘instinctively’ examines the 
contents of address locations 1F FC and 1FFD to ascertain the reset vector 
which is, of course, address 1C1D. The processor will therefore jump to 
this location and arrive at the label RESET (point 1 in figure 1). 

As can be seen from figure 3, the processor then defines which of the I/O 
lines of port B are to be programmed as outputs. By storing the data 1E in 
the port B data direction register (PBDD) port lines PB1...PB4 become 
outputs. Hopefully, you will remember from book! that certain of the 
memory locations contained on page zero are reserved for the purpose of 
saving the contents of the internal CPU registers. One such location is 
called PREG. This is where the contents of the processor status register are 

















STA —PBOD 


STAZ — PREG 


1E > PBDD; 
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} PREG + 60000106 
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Figure 3. The RESET-routine is executed when the Junior Computer is (re)initialised. 
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saved. If the monitor program is left by depressing the GO key 
immediately after the RST key (see figure 1), the contents of memory 
location PREG must have a particular value. The reason for this will 
become clear later. 

Initially, 04 is stored in location PREG. This corresponds to the interrupt 
flag being set and alt the other flags in the status register being reset. The 
processor then enters a positive number (93) into the address location 
MODE. If the contents of location MODE are not equal to zero the Junior 
Computer will operate in the AD (address) mode, if however the data held 
there is equal to zero, the DA (data) mode will be employed. In addition, 
the processor enters the value 03 into location BYTES. This means that 
three bytes are to be indicated on the six displays: two address bytes and a 
single data byte. 

At this stage it is useful to remember chapter 5 where programs 
were entered into the computer with the aid of the editor. In this instance, 
the display has a variable length which depends on the instruction shown. 
If the value contained in BYTES is @1, only the two extreme left hand 
displays will be lit. If BYTES contains @2, on the other hand, the two left 
hand and the two centre displays will! be lit. However, all the displays 
will be lit if the content of BYTES is @3. 

After this, the CPU will set up the stack pointer to point at address lo- 
cation @1FF. Since the stack pointer in the 6502 microprocessor is always 
situated on page 1, only the low order byte of the pointer value will have 
to be set (the high order byte will always be @1!). The corresponding 
instructions are: LDX #FF and TXS. As the stack pointer must also be 
saved in page zero, the low order byte will also have to stored in location 
SPUSER. 

The two subsequent instructions (CLD and SEl) ensure that the Junior 
Computer is operating in the binary mode and that any interrupt requests 
are inhibited. When the CPU finally reaches the label START, the reset 
sequence has been completed. 


SAVE 


The next item in the monitor program to be discussed is the SAVE 
routine. As we know from figure 1, the SAVE routine is entered by way 
of input @ of the monitor program. This section of the monitor saves the 
contents of all the internal CPU registers in page zero. The SAVE routine 
is also utilised when the computer is in the step mode. 

The way in which the CPU registers are saved can be seen from figure 4. 
As mentioned previously, the SAVE routine is accessed in the step mode 
by way of a non-maskable interrupt. We also know (or should do by now!) 
that the high and low order bytes of the program counter and the contents 
of the processor status register are stored on the stack (in that order) after 
a non-maskable interrupt. Prior to the NMI the stack pointer would be di- 
rected to location @1xx. The CPU will store the value of the high order 
byte of the program counter at this location and will then decrement the 
low order byte of the stack pointer. Now the stack pointer will be pointing 
to location @1xx — 1. This is where the processor stores the low order byte 
of the program counter and the stack pointer is once again decremented 
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Figure 4a. The detailed flowchart of the SAVE routine, which is executed after a 
jump to monitor via an interrupt. 


Figure 4b. The state of the stack and stack pointer at certain moments during the 
SAVE routine. 
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by one. This means it will now be pointing at location @1xx — 2. The 
contents of the status register are then stored at this location and the stack 
pointer is decremented to point at location @1xx — 3. 

By this time the processor will have reached the label SAVE in the moni- 
tor program (see figure 4). Firstly, the contents of the accumulator are 
stored in location ACC (@@F3). The routine continues by fetching the 
previous contents of the status register from the stack (PLA) and storing it 
in location PREG (@@F1). At the beginning of the next section of the 
SAVE routine (SAVEA) the processor encounters another PLA instruc- 
tion. This obtains the low order byte of the program counter from the 
stack, which is then saved in locations PCL (@@EF) and POINTL (@@FA). 
The following PLA instruction fetches the high order byte of the program 
counter from the stack. This is then saved in locations PCH (@@FQ@) and 
POINTH (@0FB). 

Just to recap briefly: before reaching the label SAVE, the stack pointer 
was directed to address location @1xx. After the interrupt the CPU saved 
the high and low order bytes of the program counter and the contents 
of the status register on the stack. Once the processor reaches the label 
SAVE, the stack pointer will be directed to address location 01xx — 3. 
Between labels SAVE and SAVEB the processor carries out three PLA 
instructions, therefore the stack pointer will again point to address lo- 
cation 01xx (in other words it will resume its original state). 

Thus, up to now, the processor has used the stack as a temporary memory 
to save the value of the program counter and the contents of the status 
register in page zero. The display buffers have also been renewed as the 
value of the program counter has been entered into locations POINTH 
and POINTL. The contents of the rest of the CPU registers are yet to be 
saved. This is accomplished after the label SAVEB where the contents of 
the Y register are stored in location YREG (@@F4) and the contents of the 
X register are stored in location XREG (@@F5). 

The value of the stack pointer is the final parameter to be saved. This is 
stored in location SPUSER with the instructions TSX and STY X-SPUSER. 
The state of the stack pointer has remained unaltered since the last PLA 
instruction. Therefore the low order byte of the stack pointer, xx, can be 
accessed from location SPUSER. 

When the processor has reached this stage in the routine the contents of all 
the internal registers will have been saved. The processor then goes on to 
fulfil an important task. It enters a number that is not equal to zero into 
address location MODE (@@FF). Asa result, the Junior Computer being in 
the step mode, after carrying out an instruction will automatically switch 
to the address (AD) mode. This prevents the programmer from inadvert- 
ently overwriting a machine instruction with incorrect data. 

The processor has now reached the label START and will once again con- 
trol the keyboard and display. By depressing the GO key the Junior 
Computer will leave the monitor program (see figure 1) and branch to the 
user’s program. The following passage deals with the process involved step 
by step. 
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Leaving the monitor program 


As we know, the Junior Computer remains inside a loop in the monitor 
program. Here it constantly multiplexes the display and scans the key- 
board waiting for a key to be depressed. If the programmer depresses the 
Go key, the computer will leave the loop and will branch into the user's 
program. From Book! we know that when the GO is depressed the 
Junior Computer wil! start work from the address shown on the display 
at that particular moment. As soon as it has left the monitor program, it 
no longer worries about the keyboard and display, but devotes its entire 
attention to the user’s program. 

Figures 5a and 5b clearly show what happens when the computer leaves 
the monitor program by way of the GO key. Figure 5 shows the actual 
program steps, which are virtually the reverse of the SAVE routine, while 
figure 5b shows the state of the stack and the stack pointer. 
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Figure 5a. The detailed flowchart of the routine that is executed after the GO key is 
depressed. This routine is the exact inverse of the SAVE routine in figure 4a. 


Figure 5b. The state of the stack and stack pointer at certain moments during the 
routine of figure 5a. 
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stack pointer 


First the CPU obtains the address of the user stack from location SPUSER 
and stores that address in the stack pointer (_DXZ-SPUSER, TXS). This 
means that the stack pointer will once again indicate the address 01xx. 
The contents of the display buffers, POINTH and POINTL, are then also 
placed on the user stack, in that order. The stack pointer will then, of 
course, be indicating address location @1xx — 2. This means that the 
contents of POINTH and POINTL will be used as the new program 
counter. The original contents of the status register are stored on the 
stack (LDAZ-PREG, PHA). The stack pointer now indicates location 
B1xx — 4. 

Once the new program counter and the previous contents of the status 
register have been placed on the stack, the contents of the X and Y index 
registers and the accumulator are restored to their original values. This 
ensures that all the internal CPU registers contain specific data and the 
Junior Computer can branch into the user’s program quite happily. This is 
actually carried out via the RTI instruction. As you will remember, fol- 
lowing an RTI instruction the contents of the status register and the low 
order and high order bytes respectively the program counter are pulled 
from the stack. In this instance the value of the program counter is 
obtained from the contents of POINTH and POINTL. This enables the 
processor to leave the monitor and continue program execution from the 
address currently on display — the start address of the user program. 

Note: If the Junior Computer happens to be in the step mode, it will 
execute the program sequence shown in figure 5a when the GO key is 
depressed. It will branch to the address shown in the display which 
contains a machine instruction and will carry out this instruction. However, 
when the opcode for the instruction is being loaded into the instruction 
register the CPU will generate a non-maskable interrupt (NMI) via its 
SYNC output. The processor therefore completes the current instruction 
and then deals with the interrupt. 

In the step mode the NMI vector points to address location 1CQ@@, which 
is the start of the SAVE routine. Now the CPU executes the program 
sequence shown in figure 4, saving the contents of all registers and 
switching the computer to the address (AD) mode. After this sequence 
the processor again arrives at the START label where it once more 
enters the loop and takes care of the display and scans the keyboard. The 
next machine instruction, together with its address, appears on the display 
and the computer waits until the GO key is depressed once more. When 
the GO key is depressed the processor branches to the address currently 
displayed to carry out the instruction shown and the whole procedure is 
repeated. 


How the Junior Computer responds to a depressed key 


This section of the chapter discusses the way in which the Junior Com- 
puter responds to any key that is depressed. To start with, the computer 
discovers whether or not a key is depressed in the loop section of the 
monitor program. The identification of the particular key, or rather the 
calculation of its value, takes place in a subroutine. At the end of the 
subroutine the key value will be held in the accumulator. As already 
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discussed in Book |, the following values have been assigned to the various 
keys: 

0:00 6:66 C:0C +:12 

1:01 7:07 D:@D GO:13 

2:02 8:08 E:@E PC:14 

3:03 9:69 F:OF (illegal key: 15) 

4:04 A:GA AD:10 

5:05 B:0B DA:11 

Figure 6 illustrates the complete key recognition sequence. A series of 
compare (CMP) instructions each followed by a branch-if-not-equal 
(BNE) instruction filter out the value of the depressed key. The CPU 
branches if the depressed key does not have the same value as that under 
comparison and passes on to the next compare instruction. lf the two 
values are the same, the processor performs the relative operations per- 
taining to that particular key. 

The keyboard of the Junior Computer can be divided into two separate 
sections: one for the data keys and one for the command keys. We have 
already seen what happens when the GO key is depressed. If the command 
key AD is depressed, the contents of address location MODE are made not 
equal to zero (93). The processor will now interpret the next keys to be 
depressed as an address. By means of the subsequent BNE instruction the 
program branches to the START label via STEPA. 


(figure 7} 
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If however, the DA key was depressed, the contents of location MODE 
would be made equal to zero, The computer will then interpret the next 
keys to be depressed as being data to be stored in the address indicated 
and then shown on the display. 

As we know, the computer increments the address shown on the display 
whenever the + key is depressed and then it displays the data contained 
in this new address. If the contents of POINTL were FF before the + key 
was depressed, for instance, this would now become @@. This means that 
the contents of the address buffer POINTH must also be modified, that is 
to say, they must be incremented by one. A BNE instruction detects 
whether or not this second correction is necessary. In either case the pro- 
gram again branches to START via STEPA. 

When the PC key is depressed, the computer copies the current position 
of the program counter into the display buffer. Only a few instructions 
are required and as the contents of the program counter and the display 
buffers themselves are all situated on page zero, the actual routine is very 
short indeed. Once this has been accomplished the monitor program once 
again branches back to START. 

By now we should know how the PC key works: If a program is executed 
in the step mode, it may be necessary to examine the contents of some, 
or all, of the internal CPU register. As these are all saved on page zero, the 
user’s program will have to be left for a while. By depressing the PC key 
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Figure 6. The detailed flowchart of the key recognition sequence. All the function 
keys are tested individually. The processor performs separate routines for each key 
according to its function. Details of the routine belonging to the GO key are given 
in figure 5, In the case of a hexadecimal key, a choice is made from two possible 
routines depending on whether the computer is in the address or data mode. 
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the previous contents of the program counter will be restored into the 
display and when the GO key is depressed the computer will continue 
operation from the point it left off before the registers were examined. 

Up to know, the monitor program has been able to establish whether one 
of the command keys have been depressed. As each key has its own par- 
ticular value, only the key values between @ and 14 may arise. Nevertheless, 
there is a possibility that the Junior Computer may calculate the wrong 
key value due to mains interference or contact bounce. Normally speaking 
this should not be possible, but for greater security the processor will 
ignore any key value greater than 14 in the section of program labelled 
ILLKEY. Following this the program (yes you've guessed it!) jumps back 
to START via STEPA (do not pass GO, do not collect £ 200!!). 


Modification of data 


If the programmer did not depress a command key, but a data key, the 
monitor program will branch to the DATA label. From this point on the 
computer processes the data keys @...F. The value of the depressed key 
is first stored in address location KEY (@@E1) leaving the accumulator free 
for other tasks. The contents of location MODE are then loaded into the 
Y index register. | 

As far as the monitor program is concerned, the data now contained in 
the Y register can have one of two values: the data can either be equal to 
zero, or not equal to zero. If, for instance, the contents of the Y register 
are equal to zero, the depressed key will be interpreted as data entry. If, 
however, it is not equal to zero, the computer knows that the programmer 
would jike to enter a new address and that the information stored in 
location KEY must be transferred to the address area of the display. A 
branch instruction (BNE) distinguishes between an address and a data 
entry: LDYZ-MODE, BNE-ADDRESS. 

If the contents of the Y register are equal to zero, data is to be entered 
and the branch to the label ADDRESS does not occur. The Junior Com- 
puter shifts the information from the depressed key into the display from 
right to left. These are the two right hand digits on the display printed 
circuit board. The series of instructions to shift the data display one digit 
to the left operate as follows: 

By using pre-indexed indirect addressing (the value contained in the Y 
register is equal to zero) the CPU loads the contents of the memory lo- 
cation indicated by the address pointers POINTH and POINTL (the data 
currently on display) into the accumulator. The value of the depressed 
key contained in location KEY has not as yet been shifted into the display. 
Assuming that the data now contained in the accumulator consists of bits 
p...w, the result after four shift left instructions will be as follows: 


pPaqrs t uv w... contents of accumulator after loading 

qrs t uv w@ ... contents of accumulator after the first ASL 
instruction 

r s t uvw @ @ . contents of accumulator after the second ASL 
instruction 

s t uvwé6 @d g contents of accumulator after the third ASL 
instruction 

t uvwgd @g oo contents of accumulator after the fourth ASL 
instruction 


After these four shifts the four most significant bits of the data byte are 
lost and are replaced by the four (previously) least significant bits. The 
four least significant bits of the data byte have now been made zero by 
the shift process. 

The contents of address location KEY are @@9@xxxx, where xxxx corre- 
sponds to the actual value of the depressed key. By ORing the contents 
of the accumulator with the value contained in location KEY the 
following result is obtained: 


t uvw@ oO @ @ ... contents of accumulator before the ORA instruction 
00660 x x x x ... contents of memory location KEY 
t uvwx xX x xX .., result (in accumulator) after the OR operation 


As can be seen, the result is that the four most significant bits remain 
unchanged and the four least significant bits become equal to the value of 
the depressed key. This effectively shifts the key value into the accumu- 
lator from right to left. The data byte thus obtained is stored in the 
location, again indicated by the address pointers POINTH and POINTL, 
shown on the display. Finally, the processor once more jumps back to 
START via STEPA. 

The inclusion of the label STEPA may appear rather superfluous at first 
sight, especially as it is immediately followed by a further jump instruction 
which leads the processor to the label START. However, the 6502 micro- 
processor is unable to jump directly to any location outside a range of 
+ 128 bytes. For this reason the processor must jump to START indirectly 
by way of STEPA. 


Modification of address 


Just as the processor can modify data stored in the RAM section of the 
computer’s memory, so new address information can be entered. In other 
words, the contents of the two memory locations constituting the address 
pointer, POINTH and POINTL, can be altered (after having depressed the 
AD key). This procedure is carried out during the ADDRESS section of 
the routine shown in figure 6. After loading the X index register with 04, 
the section of program ADLOOP — BNE — ADLOOP is performed four 
times in succession. The contents of POINTL are shifted left four times, 
the contents of POINTH are rotated left four times and the contents of 
the X register are decremented by one four times. 

During the shift instruction the most significant bit of POINTL is moved 
into the carry position and the least significant bit becomes zero. During 
the rotate instruction the most significant bit of POINTH is lost and the 
contents of the carry flag replace the least significant bit. 

Let us examine this in greater detail. If we suppose that the values of the 
bits of 

the four most significant bits of POINTH areh i J k, and 

the four least significant bits of POINTH are! m no, and 

the four most significant bits of POINTL are p q r s,and 

the four least significant bits of POINTL aret u v w, and 

the initial state of the carry flag is x, the following wil! happen: 
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The four most significant bits of POINTH have been replaced by the four 
previous least significant bits and the four least significant bits have been 
replaced by the four previous most significant bits of POINTL. The four 
most significant bits of POINTL have been replaced by the previous four 
least significant bits of POINTL and the four least significant bits have 
been made zero. 

The contents of address buffer POINTH can now remain as they are, but 
the contents of POINTL require modification. This is carried out by 
loading the contents of POINTL into the accumulator and ORing it with 
the data contained in location KEY (which, as we know, is the actual 
value of the depressed key). The result is exactly the same as that for the 
data key: 

t uv w @ _ contents of accumulator before the ORA instruction 
6069069060 x . contents of memory location KEY 

t uvwxXx x x x _ result (in accumulator) after OR operation 

The final result is then replaced in POINTL before the computer jumps 
back to START via STEPA. 

Since a hexadecimal key is represented by four bits of a byte and each of 
the six displays is capable of displaying four bits of information, it will be 
quite clear why there is no need to shift around all the information con- 
tained in the display buffers. 

All the monitor software, apart from block C of figure 1, has now been 
discussed in detail. Further instructions are required to actually show the 
contents of the display buffers on the display and to ascertain which of 
the keys were depressed. These instructions are part of several important 
subroutines which are about to be described. 


60 9 
x xX X 


Keyboard and display routines 


communicating with the Junior Computer 

Immediately after the START label the Junior Computer examines the 
keyboard and multiplexes the display. The routines involved display the 
contents of the display buffers, establish whether a key has been depressed 
and, if so, which one. The display is activated immediately after the START 
label as its duty is to report back to the operator. The START label is 
reached after one of the keys to have been depressed by the operator, via 
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one of the key routines previously described, has finished. Although 
the routine for the GO key only partly takes place in the monitor pro- 
gram, even after one (step mode) or all the instructions of the user’s 
program have been executed, the processor will return to START via the 
SAVE routine in due course. If this does not occur the programmer will 
have forgotten to include the BRK instruction at the end of the program 
(section) in question. Alternatively, the processor may ‘sit’ in the monitor 
loop and wait for new program data to be entered. 

The final method of reaching the START label is to depress the RST key 
(initialise the Junior Computer). The instructions contained in the pro- 
gram section belonging to block C in figure 1 are shown in figure 7. Ob- 
viously, more instructions are used than are actually shown due to the sub- 
routines involved. The SCAND subroutine (see later for greater detail) 
ensures that the contents of the three buffers, POINTH, POINTL and INH 
are displayed and that any depressed key is detected. The contents of the 
accumulator at the end of the SCAND subroutine will be equal to zero 
when no key is depressed, but will have a non-zero value when a key is 
depressed. The subroutine GETKEY simply loads the accumulator with 
the value of the depressed key. 

As fas as figure 7 itself is concerned, something should be said about the 
BNE and BEOQ instructions. A BNE instruction causes a branch if the 
contents of the accumulator are not equal to zero. Thus, the BNE instruc- 
tion in figure 7 tests to see whether a key is depressed. The opposite holds 
for the BEQ instructions: the processor will only branch if the contents 
of the accumulator are equal to zero. In other words, the two BEOQ instruc- 
tions in figure 7 detect whether the key has been released. 

When a key is depressed, any change in the display will occur immediately 
after it is depressed — not when it is released. The machine can therefore 
only handie one depressed key at a time, so that the key must be released 
before any other can be depressed. This is because of the combination of 
the first jump to the SCAND routine and the associated branch-if-not- 
equal-to-zero instruction (the processor wil! remain in this loop until a key 
is depressed) . 

The second jump to the SCAND routine and its associated branch (BEQ) 
instruction ensures that a depressed key is detected. Then a third jump to 
the SCAND routine takes place before the jump to the GETKEY routine. 
This may seem superfluous, but it effectively eliminates any effects of 
contact bounce between the release of one key and the depression of the 
next (see figure 8). 

Let us assume that a depressed key produces a logic level of @ and a key 
that is not depressed a logic 1 level (the voltage level on the port lines 
PA@...PA6). When a key is depressed at moment t1 the curve produced 
should, ideally, be similar to that shown in figure 8a. In practice, however, 
contact bounce causes the effect shown in figure 8b. At moments t3 
and t5 the contact bounce produces a logic 1 (non-depressed key) after the 
key was depressed at moment t1, resulting in a situation where the key is 
apparently not depressed. 

Software ensures that the key is not actually detected until after moment 
t6 in figure 8b, in other words, after the effects of contact bounce have 
died away. Thus, the apparently superfluous jump to the SCAND routine 
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Figure 7. The flowchart for the program section that scans the keyboard and 
multiplexes the display. Obviously, the flowchart is not complete due to the various 
subroutines involved. 


fills the time lapse between moments t1 and t6 and the problem is solved. 
The loop including the second jump to SCAND and the BEQ instruc- 
tion (figure 7) is left soon after the period t1 — t2 when a key Is depressed. 
After the third jump to SCAND and the associated BEQ instruction no 
branch will occur and the subroutine GETKEY will be reached soon after 
moment t6. 

Contact bounce will also occur when a key is released before another one 
is depressed. Similar to the previous situation, the key will apparently 
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Figure 8. When a key is depressed (or released) a specific change in logic level is 
involved (8a). The key is depressed at moment t1 and released at moment t7. In 
practice, however, errors could arise from contact bounce (8b). After a key has been 
depressed there are moments (t3 and t5 to be precise) when the logic level is high 
instead of low. By means of the monitor software the key is not accessed until after 
moment t6, after the contact bounce has subsided. 


still be depressed. However, by the time the SCAND routine has oeen 
completed for the third time, the contact bounce will have subsided and 
the processor wil! be ready to detect any new key depressed. 

Before we go into the subroutines SCAND and GETKEY in detail, let us 
examine the hardware involved in multiplexing the display and recognising 
which key is depressed. 


From software to hardware 


Display multiplexing 

As we know, the programmer enters information into the computer 
through the use of the keyboard and the computer ‘replies’ via the six digit 
display. We also know that during this process the input/output (!/O) 
section of the peripheral interface adapter (PIA) has an important task to 
fulfil. The input section is the keyboard via which data is entered into the 
computer and the output section is the display which is controlled by 
software. 

The relevant section of the circuit connected to ports A and B is shown in 
figure 9. Port B is programmed solely as an output and is connected to 
inputs A...D of 1C7. Depending on the bit pattern present on these 
inputs, one of the ten outputs of IC7 will be low (logic zero). Six of the 
ten outputs are connected to the common cathode of a display. For one or 
more segments of a display to light, the cathode of that display must be 
grounded and so the corresponding output of IC7 must go low. The 
following truth table may be drawn up for the BCD to decimal decoder: 


Table 1 
PB7 PB6 PB5 PB4 PB3 PB2 PB1_ PB@ _ display to be turned on 


* x x 0 1 @ 0 x Dil 
Ree GG Dig. § ADH (POINTH buffer) 
x x x 0 1 1 0 x Di3 
x x x 1 g 9g 0 x Did 
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Where a port output is indicated with an x the bit may be a @ or a 1 as the 
corresponding port fine is not connected. 

If a display is switched on and all of the outputs of IC11 are high, all 
seven segments of that display will light and an ‘8’ will appear. By turning 
off certain segments it is possible to display all the hexadecimal 
numbers from @...F (and other characters besides — more about this 
later). This is accomplished by making port A an output and using it as a 
‘segment switch’. 

Let us suppose that we wish to turn off segment ‘c’. The corresponding 
inverter output, pin 12 of 1C11, must go low. For this to happen the 
inverter input, pin 5 (connected to PA2), must go high. In other words, 
a certain segment pattern is obtained by outputting a specific bit pattern 
on port A. If a particular bit is high the corresponding segment will not 
light; if it is low, it will. 

Table 2 indicates all of the bit patterns required on the output lines of 
port A to produce the relevant hexadecima! display. The corresponding 
identification of a segment display is shown in figure 10. 


Table 2 


PA7 PA6 PAS PA4 PA3 PA2 PA1 PA@ hexadecimal 


x KX KK KK KM MK KK KK KK KR 
See-aqege-agegeaa--a 
ae-egeeaea-eseg---a+ 
Seeaagge-e-EG---6-800 
-eeeaa-age-eo-ge-an 
-~-e-eeaqaqgqeeeqgqg-aegn 
=--@--aaeaeea--eeaganc 
Qe-ea-aqgagqaeea-aqe-ao 
ANDONOBPOWMVNAAGAWNH=-a4 


During segment control port line PA7 can be used as an input as there is — 
nothing connected to this line. The bit patterns shown in table 2 are stored 
in the monitor program EPROM (location 1F@F tot 1F1€). They are, of 
course, represented in hexadecimal form (see source listing in the appendix 
of this book). 


Detecting a depressed key 


As shown in figure 9, every key has two contacts. One is connected to an 
output of IC7 and the other to one of the (output) lines of port A. The 
21 keys are arranged in a matrix of three rows and seven columns. All the 
keys in one row have a common connection to a certain output of IC7. 
Keys in the same column are connected to a single port line. 
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Figure 9. A closer look at the keyboard and display section of the Junior Computer 
circuit diagram. 


80915~7-10 





Figure 10. The segments of a display are identified by the lettersa. ..g. The bit 
pattern on port lines PA@ . . . PAG light up the various segments required to produce 
a particular character on the display. 
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In order to detect whether a key has been depressed, port A lines have to 
be programmed as inputs. If it is correctly controlled via port B, one of the 
first three outputs of IC7 (@, 1 or 2) will be low. When a key is depressed 
the same logic zero will appear at one of the (output) lines of port A. In 
this manner a depressed key can be detected and identified without error. 
The matrix row is determined by the bit pattern on port lines 
PB@...PB4 and the column by whichever of port A lines goes low. The 
two tables below sum up the situation: 


Table 3 


PB7 PBG6 PB5 PB4 PB3 PB2 PB1 PBO@_ rowof depressed key 


D C B A 
x x x 0d Q @ @ x row @ (keys @,1,2,3,4,5,6) 
x x x @ @ @ 1 x row 1 (keys 7,8,9,A,B,C,D) 
Xx x x 0 Q 1 0 x row 2 (keys E,F,AD,DA,+, 


GO and PC) 


This establishes which row the depressed key is situated in. The column 
of the particular key can be determined from: 


Table 4 
PA7 PA6 PA5 PA4 PA3 PA2 PA1 PAG 
6 5 4 3 2 1 Q column 

keys @, 7andE x i) 1 1 1 1 1 1 
keys 1,8 and F x 1 Q 1 1 1 1 1 
keys 2,9 and AD x 1 1 @ 1 1 1 1 
keys 3, Aand DA x 1 1 1 0 1 1 1 
keys 4, B and + x 1 1 1 1 0 1 1 
keys 5, Cand GO x 1 1 1 1 1 G 1 
keys 6, D and PC x 1 1 1 1 1 1 @ 


Now back to the software. 


The subroutine SCAND — minus AK 


Before going through each instruction in this subroutine, it might be a 
good idea to summarize the sequence of events first. Inside the SCAND 
there is another subroutine called SHOW, which also contains a subroutine 
called CONVD. The subroutine nesting thus formed is shown in figure 11. 
It involves the display section of SCAND, or rather, everything that 
happens before AK, the key detection portion of SCAND. 

The contents of the two address buffers, POINTH and POINTL, together 
with the contents of the data buffer INH, must be displayed. Each display 
is controlled by half of the data byte contained in each of the three 
buffers. In the subroutine CONVD, the displays are activated in turn for a 
certain period of time. During the SHOW subroutine, the processor estab- 
lishes which part of the buffers is to be displayed — which display is to 
become active after the jump to CONVD. There are two jumps per display 
buffer from SHOW to CONVD. As there are three display buffers, this 
means that there are three jumps from SCAND(S) to SHOW. 
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Figure 11. The subroutine nesting that occurs during the SCAND section of the 
monitor program. The instructions pertaining to the various subroutines are shown 
as shaded rectangles. 


Thus, during the execution of the SCAND routine all six displays will 
light. Since there is a short delay joop (the second jump to SCAND plus 
the associated BEQ instruction in figure 7) the displays are in fact 
accessed periodically. This is termed software controlled display multi- 
plexing. 

The instructions used in the subroutine SCAND are given in figure 12. The 
first of these cause location INH to be used as a data buffer: the contents 
of the memory locations indicated by POINTH and POINTL are entered 
into INH. (In the editing mode the three display buffers are used for 
other purposes). The program then moves on to the next section, 
SCANDS. This starts by programming port A lines (which will act as a 
segment switch) as outputs. The X index register is then loaded with 8. 
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Figure 12. The detailed flowchart of the SCAND subroutine. It is structured so that 
the second half of it, AK, can be used as a separate routine by the programmer. 
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This value is transferred to the display control, C7, via port B during the 
CONVD subroutine. The X index register thus controls the display digits 
via port B and IC7 and is modified during subroutine SHOW and CONVD 
so that it always indicates the next display to be switched on. 

Next, the Y index register is loaded with the contents of location BYTES. 
This determines how many of the displays are to be lit. When the RST 
button is depressed, location BYTES is loaded with @3. This means that 
the contents of all three data buffers (POINTH, POINTL and INH) are to 
be displayed. Then the accumulator is loaded with the contents of 
POINTH and the processor jumps to the SHOW subroutine. The data 
contained in location POINTH is split into groups of four bits each and 
these are presented to the corresponding displays during the SHOW and 
CONVD subroutines, that is, to displays Di1 and Di2 (see figure 11). 
After this the Y index register is decremented by one and the processor 
returns to the SHOW subroutine to display the contents of POINTL in 
displays Di3 and Di4. The Y index register is then decremented and the 
contents of INH are transferred to displays DiS and Di6. All that remains 
is to program port A lines as inputs in preparation for the program section 
AK to follow later. 

The use of the Y index register as a display buffer counter may seem 
superfluous here, seeing as the number of buffers to be displayed has 
already been determined. However, the SCANDS subroutine is also used 
for editing purposes when the length of the display varies. Thus it is 
necessary to use the Y index register as a counter in this subroutine. 


The subroutine SHOW 


At the start of this subroutine (see figure 13) the contents of the buffer to 
be displayed are held in the accumulator. Each of the two halves of a 
buffer data byte has its own display digit. This means that there are always 
two jumps involved from SHOW to CONVD. The latter subroutine oper- 
ates by using the accumulator as an index to obtain the correct seven 
segment information to be displayed. This means the most significant bits 
of the data byte held in the accumulator must be zero. 

since the multiplex operation controls the six displays from left to right, 
the four most significant bits need to be presented first followed by the 
four least significant bits. Therefore, by repeating the instruction LSR-A 
four times in succession the four least significant bits are replaced by 
the four most significant bits and the four most significant bits become 
zero. In order that the four least significant bits can be displayed after- 
wards the accumulator contents are saved on the stack before the shift 
operation by means of the instruction PHA. The stack will then be used as 
a temporary store. The buffer counter contents are also saved as the Y 
index register is required for other tasks during the subroutine CONVD. 
Now, the CONVD subroutine can be called up to convert the (previous) 
four most significant bits of the data byte into a seven segment bit pattern 
to be shown on the display. Exactly how this conversion takes place will 
be seen later. 

After the return from subroutine CONVD to subroutine SHOW the 
original state of the accumulator is restored. It will again contain every- 
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Figure 13. The detailed flowchart of the SHOW subroutine which assembles the data 
to be displayed in the accumulator. 


thing to be displayed on the two relative displays. Now, the four least 
significant bits are to be displayed and the four most significant bits 
removed. This is accomplished by ANDing the contents of the accumu- 
lator with OF. A further jump to the CONVD subroutine causes the four 
least significant bits of the data byte to be presented to the appropriate 
display. 

Upon the processor's return from CONVD to SHOW the original state of 
the buffer counter is restored (LDY-TEMP), so that the computer is able 
to take care of the next data buffer to be displayed. 


The subroutine CONVD 


As mentioned previously, this subroutine obtains the seven segment code 
for the particular four data bits to be displayed. During the process a hexa- 
decimal number must be converted into a corresponding seven segment 
code. Before the CONVD subroutine can be called the four least significant 
bits of the data byte in the accumulator must correspond to the value of 
the depressed hexadecimal key and the four most significant bits must be 
zero. The complete subroutine is illustrated in figure 14. 

Initially, the hexadecimal value to be displayed is transferred into the Y 
index register. Post-indexed indirect addressing is then used to load the 
accumulator with the corresponding value from the look-up table. !f, for 
example, the figure ‘D’ is to be displayed, the accumulator must contain 
the seven segment code of 21. The accumulator contents are then 
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Figure 14. The detailed flowchart of the CONVD subroutine which transfers the data 
in the accumulator to the Y index register and thus obtains the correct seven segment 
code from the look-up table. 


transferred to port A and the contents of the X index register to port B, 
which now functions as a display digit selector. The display digit will light 
according to the bit pattern obtained from the look-up table. The question 
now is: for how long does it remain lit? The answer being: for the duration 
of the loop DELAY-BPL-DELAY. The processor remains in this loop until 
the N flag is set. Thus, a display is switched on for a little more than 
630 us. When the delay loop is over the Y index register will contain the 
value FF. The processor transfers this bit pattern to the port A lines 
thereby switching off all the display segments. The instruction for this is 
STY-PAD. The following instructions (LDY #06 and STY-BPD) place the 
‘display selector’ into the neutral position and the unconnected output of 
IC7 (pin 4) becomes active and none of the display cathodes will be low, 
At the end of the CONVD subroutine the X index register is incremented 
twice in order to enable the next digit to be displayed. 

Note: The four most significant bits of the accumulator contents must be 
equal to zero before the jump to CONVD, as otherwise the contents of 
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the Y index register would become greater than QF and that would mean 
exceeding the highest address of the look-up table (1F1E). As there is 
still memory following 1F1E, segments would light at random and give an 
incorrect indication. 


Section AK of the SCAND subroutine 


The AK section completes the SCAND subroutine and serves to detect 
whether a key is depressed. As we know, the keys are arranged in a matrix 
of three rows and seven columns (see figures 9 and 16). The bit pattern 
presented to the port B lines determines which display is ‘on’ and which 
row is to be scanned for a depressed key at a particular moment. Port B 
is controlled by means of the X index register. As a reminder, the contents 
of the accumulator at the end of the SCAND subroutine will not be equal 
to zero if a key is depressed. 

At the start of the AK routine all port A lines are pulled ‘high’ by internal 
resistors (these lines were programmed as inputs immediately before the 
AK routine). The Y index register is then loaded with 03 and is used asa 
row counter. There are three rows to scan: ROW@, ROW1 and ROW2. 
The contents of the X index register determine which of the three is 
selected via port B. The hexadecimal value FF is then loaded into the 
accumulator (ONEKEY). The contents of the X index register are then 
transferred to port B and ROWG is taken low (see table 3). The value in the 
X index register is then incremented twice in preparation for the following 
row. The contents of the accumulator are then ANDed with the bit 
pattern presented to the port A input lines. The value in the Y index 
register is then decremented by one. In the end, after the loop AKA- 
BNE-AKA three times, the number of zeros in the accumulator will 
correspond to keys that are depressed simultaneously in any column 
(COL@...COL6). Normally, however, only one key will be depressed 
at a time (and the processor is so fast that if two keys were depressed at 
the same time only one would be ‘seen’). If, for example, one of the keys 
3, Aor DA in column 3 were depressed, bit 3 in the accumulator would 
be zero after the AND instruction. The display/row selector (IC7) is then 
placed in the neutral position (as in the CONVD subroutine) with the 
instructions LDY #06, STY-PBD. Further details of this can be found in 
tables 1 and 3. 

The penultimate instruction (ORA 80 — not counting the RTS instruc- 
tion) causes bit 7 in the accumulator to become one. This is important as 
port line PA7 could well be used as an interrupt input in conjunction with 
a peripheral device such as a printer. This means that bit 7 could be either 
high or low at any time. Preparation is now complete for the final instruc- 
tion (EOR # FF) which inverts all the bits in the accumulator. Any of the 
bits b@.. . b6 in the accumulator could be zero after the loop AKA-BNE- 
AKA if a key was depressed. After the inversion that bit will be one and 
the rest zero. This means that the contents of the accumulator will not be 
equal to zero if no key is depressed. Thus, the sole purpose of the AK 
routine is to test to see if a key was depressed or not. The following 
subroutine to be discussed calculates the actual value of the depressed 
key. 
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The subroutine GETKEY 


Once the processor has determined that a key has indeed been depressed 
the next task is to calculate the value of the key. This is accomplished 
during the subroutine GETKEY. Figure 16 shows the layout of the keys 
in the matrix and also indicates the values allocated to the particular 
keys. 

The series of instructions contained in the GETKEY subroutine are shown 
in figures 15a and 15b, To make things clearer, the section of program 
labelled ONEKEY (see figure 12) is shown again. At the start of the 
GETKEY subroutine the hexadecimal value 21 is loaded into the X index 
register. As a result, ROW@ will be scanned at the next jump to ONEKEY. 
The Y index register is loaded with @1, as ONEKEY must only deal with 
one row. If a key was depressed after the return from ONEKEY, the 
contents of the accumulator will not be equal to zero. The following 
BNE instruction will then enable the program to branch to KEYIN. If 
no such key was discovered, the value contained in the X index register 
is tested. If this value is not equal to 27 the program will branch back to 
label GETKEA and the subroutine ONEKEY will be called once more. 
Why must the contents of the X index register be compared with 27? At 
the start of the GETKEY subroutine the value in the X register is made 
equal to 21 and so ROW@ will be accessed. During the subroutine 
ONEKEY the X index register will be incremented twice, making its value 
23. As this does not equal 27, subroutine ONEKEY is run again, although 
this time ROW1 will be accessed. After the return from ONEKEY the 
value in the X index register will be 25. If no key in ROW1 was depressed, 
the processor must again jump to ONEKEY after which the value in the X 
index register will be 27. 

Now all the rows have been scanned and if still no key is found to have 
been depressed there must be an error somewhere. In that case, the com- 
puter must not branch to KEYIN and start calculating the key value. 
Instead, after the compare instruction, the accumulator is loaded with 15 
to instruct the computer to ignore the ‘depressed’ key and to go back to 
scanning the keyboard. 

From label KEYIN onwards the computer calculates the value of a valid 
depressed key. The coordinates of the various keys are given in figure 16. 
The KEYIN routine starts by loading the Y index register with the value 
FF. The processor then shifts the contents of the accumulator to the left 
at least twice. Prior to this the accumulator contained seven zeros and a 
one (the one indicating the column of the depressed key). The contents 
of the accumulator are shifted left until the carry flag is set. After each 
shift the state of the carry flag is tested and if it is not set the value in the 
Y index register is incremented. Therefore, the value in the Y register now 
indicates the column of the depressed key. With respect to the keys in 
ROWG@, the value in the Y index register will be equal to the value of the 
key. However, with respect to ROW1 and ROW2 the values @7 and @E 
respectively have to be added. Hexadecimal @E is twice the value of Q7. 
These additions are taken care of in the program section labelled 
KEYINC in figure 15a, However, before the program has reached that 
point, the contents of the X index register, the row information, is trans- 
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Figure 15. The detailed flowchart of the GETKEY subroutine which determines 
whether a valid key has been depressed and if so assigns the correct value to it. 
The program section labelled ONEKEY (see figure 12) has been repeated here for 
‘the sake of clarity. 


ferred to the accumulator. Its value will be 23 for a key in ROWQ, 25 for 
a key in ROW1 and 27 for a key in ROW2. This value is then masked by 
the instruction AND #@F to remove the four most significant bits of the 
byte. The contents of the accumulator are shifted right one bit position, 
which effectively divides the value in the accumulator by 2. Thus, it 
follows that the contents of the accumulator now become @1 for a de- 
pressed key in ROW@, @2 for a key in ROW1 and Q3 for a key in ROW2. 

This value is then transferred to the X index register and the contents of 
the Y index register are transferred to the accumulator. After the label 
KEYINC either the value @7 or @E is added to the column number, de- 
pending on the row of the depressed key. The processor does not enter 
the loop KEYINC-BNE-KEYINC if the key was in ROW@, as the value 
in the X index register (after label KEYIND) will already be zero. When 
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the processor returns from the GETKEY subroutine the value of the 
depressed key will be contained in the accumulator. 

To fully understand how the subroutine works let us see what happens 
when key ‘C’ is depressed. To start with the X index register is loaded 
with the value 21 and the Y index register with the value 01. Then we 
jump to subroutine ONEKEY. Here the accumulator is loaded with FF 
and the value contained in the X index register (= 21) is transferred to the 
(output) lines of port B. This effectively grounds one side of all the 
switches connected to ROW@ via IC7. Key ‘C’ however, does not belong to 
ROWG@, but to ROW1. Thus the following situation will occur when the 
keys in ROWG@ are read via port A: 


11111171 accumulator (A-FF) 
x1111111  =portA 

X1111111 AND with FF 
11111111 OR with 8@ 
00000000 EOR with FF 


Since the contents of the acumulator are zero, the processor does not 
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Figure 16. The keyboard matrix showing the key values and the corresponding row 
and column data. 


branch to label KEYIN. During the subroutine ONEKEY the contents of 
the X index register will also have changed: 


001000011 = 21 (initially) 
001200010 = 22 (after first INX) 
0019000011 = 23 (after second INX) 


Upon the return from ONEKEY the BNE instruction causes the processor 
to react to the last register contents, or rather to the last state of the 
Z flag. The last instruction to affect the Z flag was EOR #FF in the 
ONEKEY subroutine. Since the ‘C’ was depressed, the processor will not 
branch to KEYIN as the Z flag is high. The processor then tests to see 
whether the contents of the X index register are equal to 27 yet. But as 
we have only jumped to the ONEKEY subroutine once so far, the contents 
of the X index register will be 23. The processor therefore branches back to 
GETKEA, the Y index register is loaded with 01 once more and we jump 
back to ONEKEY. The accumulator is once again loaded with FF and the 
new contents of the X index register are transferred to the port B (output) 
lines. The common connection of all the keys in ROW1 will now be low. 
This is where key ‘C’ is situated and the bit pattern on port A will there- 
fore be: 


x1111101 
PA1 = column 1 (see figure 16) 


and after ANDing with PAD the accumulator contents will be: 
x1111101 
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After ORing this with 80 the contents of the accumulator will be: 
11111101 

Finally, after the Exclusive OR with FF the accumulator will contain: 
00000010 

Meanwhile, the contents of the X index register have become 25. When 
the processor returns from ONEKEY the BNE instruction is encountered 
once again. Since the contents of the accumulator are no longer zero 


(00000010) the processor will branch to KEYIN. Here the accumulator 
contents are shifted left until the carry flag (C) is set: 


carry contents of Y 

flag register after 
ASL-A and before 
BCS 


00000010 FF start 

00000100 FF after the 1st ASL-A 

00001000 00 after the 2nd ASL-A 
000190000 01 after the 3rd ASL-A 
00190000 Q2 after the 4th ASL-A 
01000000 03 after the 5th ASL-A 
10000000 04 after the 6th ASL-A 
00000000 05 after the 7th ASL-A 


“"OOo0 0098 x 


After seven shift instructions the carry flag has been set and the program 
branches to label KEYINB. Since the ‘C’ key is the one depressed, the 
contents of the X index register will be 23 and the contents of the Y index 
register will be 5. 

The contents of the X index register are then transferred to the accumu- 
jator: 


00100191 accumulator contents before ANDing with 
00001111 OF 

00000101 accumulator contents after ANDing 
00000019 accumulator contents after LSR-A (= @2) 


The contents of the accumulator (@2) are again transferred to the X index 
register and the contents of the Y index register (@5) are transferred to the 
accumulator. As the accumulator contents are not negative the processor 
branches to label KEYIND (via the BPL instruction). Here, the X index 
register is decremented by one, making its contents one. Since this is not 
zero the processor branches back to KEYINC, where the value @7 is added 
to the contents of the accumulator (the key column). This means that the 
value now contained in the accumulator is 05 + @7 = OC, which is the final 
value of key ‘C’. The contents of the X index register are then 
decremented once more to become zero, so the processor does not branch 
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back to KEYINC, but continues until it reaches the RTS instruction. The 
correct value of the depressed key will, therefore, be held in the accumu- 
lator after the return to main program execution. 

This brings us to the end of chapter 7. We have discussed a total of 187 
bytes of the main monitor program together with 152 bytes of monitor 
subroutines, There are, of course, 1024 bytes of monitor program con- 
tained in the EPROM. The remaining subroutines will be discussed in the 
following two chapters concerning the editor and the assembler. 
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The Editor program 


The ‘intelligence’ behind simple program entry 


This chapter is devoted to the subroutines used by the editor 
section of the monitor program. What happens inside the Junior 
Computer when information is entered into the memory in the 
editor mode via the command keys INSERT, INPUT, DELETE 
etc.? How does the editor store a program so that it can be 
processed by the assembler? All these questions will be answered 
with the aid of flowcharts during the course of this chapter. 


As mentioned previously, the EPROM contains three separate sections: 
the main monitor program which controls address and data display, the 
editor and the assembler. Of these three it is the editor which takes up 
most memory space. Chapter 5 showed us how effective the editor 
routine can be when rather lengthy programs are entered into the com- 
puter. Now it is time to examine the editor section itself, which consists 
of a large number of subroutines, in much greater detail. 

These subroutines are structured so that they can be incorporated into 
user programs if required, thereby saving a lot of time and effort when 
developing programs. One subroutine has already been introduced in 
Book |: the subroutine GETBYT, which ‘reads’ two hexadecimal keys and 
enters their value into the accumulator. 

The editor responds to the five command keys SEARCH, INSERT, INPUT, 
SKIP and DELETE and to the data keys @...F. When one of the keys 
SEARCH, INSERT or DELETE is depressed, the processor expects either 
two, four or six data keys to follow. This is because the 6502 micro- 
processor instructions vary in length. They can be one, two or three bytes 
long. tn the case of the SEARCH command, the Junior Computer requires 
four data keys to be depressed, as a specific 16 bit (two bytes) pattern 
must be traced in the (programmable) memory. 

Before we deal with the main section of the editor and its associated sub- 
routines, let us take a look at a general survey of the special characteristics 
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inherent to the editor which were not discussed in chapter 5. There we saw 
how the editor could be used, whereas this chapter will illustrate how the 
processor performs all the operations required by the editor routine(s). 


Characteristics of the editor 


Before the editor can be run, the start and end addresses of the memory 
range in which the program is to be stored must be keyed in to 
the memory locations BEGADH, BEGADL and ENDADH, ENDADL 
respectively. It is possible to enter instructions into the Junior Computer 
by using the editor without having to activate the assembler afterwards. In 
this instance, however, the program must not contain any labels, as the 
microprocessor itself is not able to decode the label identifier FF. It 
follows, therefore, that if there are any labels in the entered program, the 
assembler will have to be started once editing is complete. As you know, 
the assembler removes all the labels from a program entered via the 
editor. , 

The editor also makes use of another pseudo-instruction that the 6502 
microprocessor would otherwise ignore. This is the ‘End Of File’ (EOF) 
character 77. This is automatically entered after all the other program 
instructions. When using the editor to enter a program it is a good idea to 
leave at least six memory locations clear between the end of the program 
and the end address of the available memory (ENDADH, ENDADL). 
Otherwise it will be very difficult to start the assembler, as the symbol 
table prepared by the assembler could overwrite the tail end of the user 
program (see chapter 9 for further details). 

Once the editor has been started, we can enter instructions into the Junior 
Computer with the command keys INSERT and INPUT. Whenever a 
complete instruction is keyed in, the occupied memory space will ‘grow’ 
by one, two or three memory locations. The exact amount is determined 
by the opcode of the entered instruction. At the same time, the EOF 
character will be shifted down by the same number of spaces. lf, for 
example, a two byte instruction is keyed in, the EOF character will move 
down by two memory locations. 

However, if the DELETE key is depressed, quite the opposite happens. 
The instruction shown on the display will be erased from the Junior 
Computer’s memory, leaving a gap which the editor will fill by moving up 
the data block following the deleted instruction by the requisite number 
of address locations. Here again, the position of the EOF character will be 
adjusted: it will be moved up by the same number of bytes. — 

The SEARCH function is used to track down a particular two-byte 
‘pattern’ within the defined memory area of the Junior Computer. This 
could be either an opcode plus first operand byte, or a label with the 
pseudo opcode FF plus the label number. The search starts off at the 
beginning of the defined memory area (BEGADH, BEGADL) and ends 
at the address containing the opcode of the double byte in question. 

This also happens during the SKIP function, which traces the instruction 
immediately following the one currently on display. Both the SEARCH 
and SKIP functions can report an error. {f, for example, the former is used 
to try to find a non-existent double-byte pattern, the display will show 
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EEEEEE until the SEARCH key is released. Then a random instruction 
will be shown on the display, which is where the Junior Computer stopped 
searching. The SKIP function also has this facility. The EOF character 
indicates the end of an entered data block made up from instructions and 
labels. If the processor discovers more instructions behind the EOF charac- 
ter, the message EEEEEE will again be shown on the display until the 
SKIP key is released. 


The address pointers in the editor 


The memory range which is used by the editor to store data and which 
runs from BEGAD to ENDAD is called a ‘file’. This can be either a com- 
plete page or a data block. Four address pointers are required to take care 
of file management. They are: 

1) BEGAD: This is stored in memory locations @@E3 and @OE2 — 
BEGADH and BEGADL respectively. This pointer thus establishes the start 
address of the file in which the editor is to store the program data. 

2) ENDAD: This is stored in memory locations @@E5 and QOE4 — 
ENDADH and ENDADL respectively. This pointer therefore defines the 
end address of the file in which the editor is to store the program data. 

3) CURAD: This is stored in memory locations @@0E7 and @GE6 — 
CURADH and CURADL respectively. CURAD is an abbreviation for 
‘CURrent ADdress’. The editor requires this pointer to control the seven 
segment display on the Junior Computer. Since al! the instructions in the 
file are shown on the display, the address pointer CURAD will change 
constantly during editing. It will always point to the instruction currently 
being displayed. 

4) CEND: This is stored in memory locations Q@E9 and OOE8 — 
CENDH and CENDL respectively. CEND is an abbreviation for ‘Current 
END address’. Like CURAD, it will change constantly during the editing 
procedure. It will change whenever the command keys INSERT, INPUT or 
DELETE are used to enter or erase program instructions. The address 
pointer CEND is used to point to the address location immediately 
following the EOF character 77. If, for instance, the EOF character is 
located at address 9259, CEND will be pointing to location 925A. 

The current address pointer CURAD and the end of program pointer 
CEND are initialised as soon as the editor is activated. In the case of a 
‘cold start entry’ (see chapter 5) CURAD will point to the start address of 
the program file. This is where the EOF character 77 is stored initially, 
which is what is seen on the display each time a cold start entry into the 
editor is made. As no instructions have, as yet, been entered, CEND will 
point to BEGAD + 1. The initial situation as described is illustrated in 
figure 2a. 

In addition, the editor features a ‘warm start entry’. When the editor is 
started in this mode it operates as normal, but without affecting the cur- 
rent address pointer CURAD, the end of program pointer CEND or the 
EOF character. As discussed in chapter 5, the editor can be activated by 
depressing the GO key or the ST key. The start address for a cold start 
entry is |CD5. This address must be stored in the NMI vector if the editor 
is to be started with the ST key. The same is of course true of the warm 
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start entry. In this mode the editor is started from address 1CCA. The 
editor can be left with the aid of either the RST key or the ST key. The 
latter method will involve modifying the contents of the NMI vector 
(see chapter 5). 
In the editing mode the display buffers will no longer contain address 
information and corresponding data, but instructions to be executed. 
These buffers are still called POINTH, POINTL and !NH aithough they 
perform an entirely different function to that described in chapter 7. Data 
contained in POINTH will still be displayed on Dil and Di2, data con- 
tained in POINTL will be displayed on Di3 and Di4 and the data contained 
in INH will be displayed on Di5 and Di6. The functions of the display 
buffers during the editing mode are as follows: 

During data entry the display is filled from left to right. 
“ The computer accepts data one byte at a time, so that two data keys 

have to be depressed before the entered byte appears on the display. 
* When entering instructions, the computer will first evaluate the opcode 

to determine the length of the instruction. This is to see whether the 
instruction is one, two or three bytes long. Once the opcode has been 
evaluated therefore, the computer will know how many displays to enable 
(Dil... Di2, Dil... Di4 or Dil... Di6). 
During the editing routines the display buffers will contain the following: 
POINTH: will always contain the opcode of an instruction or the pseudo 
opcode of a Jabel. 
POINTL: will always contain the first operand byte (if present) or the 
label number. 
INH: will always contain the second operand byte (if present) or the 
limiter byte of a label. 
Before considering the editor software in detail, it may be as well to say a 
few words about the functions INSERT, INPUT and DELETE. The initial 
situation is illustrated in figure 1a. Here the address pointer CURAD is 
pointing to opcode 3. This opcode, together with the two operand bytes 
following it, is shown on the display. The EOF character is located at 
address xxxx — 7 and the end of program pointer is pointing to address 
location xxxx. If the programmer wishes to enter a new instruction such 
as LDA #FF, for instance, immediately after the one currently on display, 
the INPUT key must be used (see figure 1b). The hexadecimal code AQF F 
will then be loaded into the address locations behind the instruction that 
was previously on display (opcode 3 plus the two operand bytes) and the 
processor will move all subsequent bytes down by two memory locations. 
The EOF character will also move down two places as the instruction 
LDA #FF is two bytes long. If, however, the programmer wishes to enter 
the new instruction immediately before the one currently on display, the 
INSERT key must be used. This is shown in figure 1c. Here the hexadeci- 
mal code for the instruction LDA #FF is placed in front of the instruc- 
tion that was previously on display. Again, all subsequent bytes (and the 
EOF character) are moved down two address locations. In both instances, 
the EOF character will be located at address xxxx + 7 and CEND will 
point to location xxxx + 2. 
In chapter 5 we mentioned the fact that during cold start entry the first 
instruction must always be entered by means of the INSERT key. The 
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Figure 1. The difference between the INPUT and INSERT functions. When an 
instruction is entered into the file using the INPUT command (1b) it is placed behind 
the instruction currently on display. When the INSERT command is used (1c) it 

is placed in front of the current instruction. Figure 1a shows the initial situation, 
where CURAD is pointing to opcode 3. 


reason for this is illustrated in figure 2. The initial situation is given in 
‘figure 2a. From figure 2b it can be seen what happens when the label 
FF 15 0@ is entered into the Junior Computer memory using the INPUT 
key. The EOF character will remain where it was and the label FF 15 @@ 
will end up behind it — with disastrous results! 

The correct procedure for a cold start entry is given in figure 2c. Here the 
programmer uses the INSERT key before keying in the label. This means 
that the label is correctly positioned in front of the EOF character. As the 
label is three bytes long, the EOF character has moved down three address 
locations. At this moment in time the complete file consists of the fabel 
FF 150@@ and the EOF character 77, starting at BEGAD and ending at 
CEND. The more instructions that are stored in the file, the further down 
the EOF character will drop. The CEND pointer will then also be moved 
further away from the BEGAD pointer, indicating that the file is growing 
all the time. 

The effect of the DELETE function is illustrated in figure 3. Let us 
suppose that the instruction LDA #FF is situated somewhere in the file 
and is followed by the label FF 3B 00. We now wish to erase the instruc- 
tion LDA # FF (hexadecimal code AOFF) from the file. Once the instruc- 
tion has been located, using the SEARCH function for instance, the 
display will show the code AQFF and the DELETE key can be depressed. 
This has the opposite effect of the INPUT and INSERT keys in that the 
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Figure 2. When the editor is started via a cold start entry, the pointers CURAD and 
BEGAD will both indicate the EOF character 77 (2a). 1f the INPUT function is used 
to enter the label FF 15 @@ (2b) it will be stored after the EOF character, which is, 
of course, incorrect. The correct procedure is to use the INSERT function (2c) so 
that the tabel is stored before the EOF character. 
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Figure 3. When an instruction is to be erased from the file, the DELETE function is 
used. This effectively shifts the entire data block upwards in the fite so that the 
unwanted instruction is overwritten. 


instruction currently on display is erased from memory and the complete 
section of file following it is moved up two locations. This means, of 
course, that the EOF character and the CEND pointer also move up two 
places. The file will now be two bytes shorter than it was previously. 


The basic flowchart of the editor 


The basic flowchart of the editor section of the monitor program is shown 
in figure 4. This can be compared, to a certain extent, to that given in 
figure 1 of chapter 7. As can be seen, there are various similarities and 
various differences between the two. 

Taking the similarities first: the ‘warming up session’ required before the 
computer can operate in the editor mode can be likened to the RESET 
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routine which initialises the main section of the monitor. Furthermore, the 
central label CMND in the editor resembies the START label in the main 
monitor section. Even the individual operations that the processor per- 
forms between the labels CMND and SEARCH can be compared to block 
C in figure 1 of chapter 7: in both sections the computer scans the key- 
board and multiplexes the display. After the SEARCH label in figure 4 the 
processor scans each of the command keys (SEARCH, INSERT, INPUT, 
SKIP and DELETE) in turn to ascertain which of the functions the pro- 
grammer wishes to execute. 
This covers the similarities between the two basic flowcharts. What about 
the differences? In contrast to the main monitor routine, the editor has no 
clear exit point from which it can be left. Once the editor is up and 
running by way of a cold or warm start entry, it cannot be left by depress- 
ing one of the command keys as in the case of the GO key in the main 
monitor routine. As fas as the computer is concerned, the editor is an 
infinite loop which can only be exited from by depressing one of the 
hardware keys RST or ST. 
The label ERRA constitutes a further difference. It belongs to a section of 
program in the editor which causes the ‘text’ EEEEEE to be displayed 
whenever the programmer is guilty of an operational error. The operation 
of the main monitor routine is so elementary that there is no real need for 
any error messages. However, when instructions are entered in the editing 
mode, it is very easy to make mistakes which the computer must bring to 
the attention of the programmer. 
Errors will be reported in the following instances: 

The programmer uses the SEARCH function to trace a certain two-byte 

pattern which is supposedly situated somewhere in the file. If this 
particular pattern turns out to be non-existent, the Junior Computer will 
display the error message EEEEEE until the SEARCH key is released. 
* The programmer uses the SKIP function to quickly run through a file. 

Eventually the programmer reaches the EOF character, but inadver- 
tently depresses the SKIP key once more. As we know, the file must end 
after the EOF character. Therefore, the computer will once again display 
EEEEEE as an indication that the programmer has exceeded the bound- 
aries of the file which extends from BEGAD to CEND. 

The computer will also report an error whenever the programmer 

depresses the wrong key. An example of this is when the programmer 
depresses a data key when the processor is waiting for a command key. 
There is one final difference between the two basic flowcharts. It is clear 
from figure 4 how the various command keys are tested, but where does 
the computer process the data keys @...F when the machine is in the 
editing mode? It is common knowledge by now that the data keys are 
intended for the purpose of entering instructions, in other words opcodes 
and operand bytes. In fact, the hexadecimal keys are taken care of during 
the SEARCH, INSERT and INPUT routines, which is the reason for all 
the branches back to the SEARCH label in the basic flowchart (figure 4). 
During these routines the GETBYT subroutine, which is familiar to us 
from Book |, is used to fetch the information from two data keys de- 
pressed in succession and to combine the data to form a single byte. The 
GETBYT subroutine will only accept hexadecimal keys and will ignore 
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command keys. As a result, it is possible for the programmer to switch 
over to command entry during data entry (by depressing one of the keys 
SEARCH, INPUT, INSERT, SKIP or DELETE) without the wrong data 
being stored in the file. 

The contents of the three display buffers will not be copied from the 
display into the file until the programmer has entered the entire instruc- 
tion. If the programmer therefore depresses a command key while entering 
an instruction, the editor program will branch to the SEARCH label and 
will then take care of the new command. If, however, the programmer has 
typed in the whole instruction, the program will branch to the centre 
label CMND. The editor will then wait for a new command key to be de- 
pressed and will once again branch to the relative command key routine. 
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The detailed flowchart of the editor 


Now that we have discussed the basic flowchart of the editor, it is time to 
take a much closer look at the routines etc. involved. The detailed flow- 
chart of the editor program is given in figure 5, albeit without the 
initialisation routine required for a cold start entry. This routine, which 
prepares the memory of the Junior Computer for data entry is given in 
figure 6. 

As can be seen from the two figures, the editor is made up from a number 
of subroutines which we will get to understand more fully when discussing 
the overall program. By the way, as with most of the subroutines con- 
tained in the monitor EPROM, it is possible to incorporate these routines 
in your own programs. This can, in fact, save a great deal of time and 
effort when developing programs. 


Figure 4. The basic flowchart of the editor section of the monitor program. 
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Figure 5. The detailed flowchart of the editor routine, apart from the cold start entry 
section. 
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Cold start entry 


The detailed flowchart of the section of program that is executed when 
the editor is activated via a cold start entry is given in figure 6. The editor 
program starts with the subroutine BEGIN, which is shown in detail in 
figure 7. This consists of only four instructions, but it is extremely import- 
ant for both the editor and the assembler. The BEGIN subroutine ensures 
that the contents of the display pointer CURAD are the same as the 
contents of the address pointer BEGAD. As you know, BEGAD points to 
the start address of the file where the programmer intends to store his/her 
series of instructions and labels. 

After returning from the BEGIN subroutine, the processor makes the 
contents of the variable end address pointer CEND equal to BEGAD + 1 
with the aid of the X and Y index registers. This is quite logical when you 
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Figure 6. The detailed flowchart of the section of program that is executed when the 
editor is started via a cold start entry. 
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Figure 7. The subroutine BEGIN simply ensures that the contents of the pointers 
CURAD and BEGAD are equal. 


consider that the memory location being pointed to by CURAD is to be 
loaded with the EOF character 77 and that CEND is to point to the mem- 
ory location following the EOF character. | 

How is CEND made equal to BEGAD + 1? First of all, the contents of the 
X index register (= BEGADL) are incremented by one. If the contents of 
BEGADL were FF prior to this, the contents afterwards will be 00. This, 
of course, means that the contents of BEGADH will also have to be 
increased by one. The processor checks out this situation by means of a 
BNE instruction and if true the contents of the Y index register 
(=BEGADH) are also incremented. Since the pointer BEGAD is not 
allowed to change during the entire editor routine, the two index registers 
are used as temporary storage locations. The two subsequent instructions 
(STXZ-CENDL and STYZ-CENDH) ensure that CEND = BEGAD + 1. The 
three final instructions in this section of program simply store the EOF 
character 77 in the memory location being pointed to by CURAD. Now 
the initial situation as given in figure 2a will have been achieved. 


Keyboard and display 
the SCAN subroutine 


The program section between the labels CMND and SEARCH in figures 
4 and 5 is restricted to scanning the keyboard and multiplexing the dis- 
plays. This is where the processor determines whether one, two or all 
three display buffers are to be enabled and whether any key in the Junior 
Computer keyboard matrix has been depressed. Once a depressed key has 
been detected, the processor will calculate tts value in the usual manner. 
These tasks are carried out in the subroutine SCAN, the detailed flowchart 
of which is given in figure 8. 

At the beginning of this subroutine, the X index register is loaded with 
2 and the Y index register is loaded with @@. As a result, from the label 
FILBUF onwards, the contents of three consecutive memory locations 
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Figure 8. The SCAN subroutine is responsible for scanning the keyboard for a 
depressed key and multiplexing the display. At the end of this subroutine the value 


of the depressed key wil! be held in the accumulator. 
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contained in the file are copied into the three display buffers POINTH, 
POINTL and INH as follows: 

1.X=@2 Y=: contents of CURAD +> POINTH (@QFB) 
2.X=@1 Y=@1: contentsof CURAD+1 > POINTL (@@FA) 

3. X=@0 Y=902: contentsof CURAD+2 ~ INH (QOF9) 

4, X=FF: the subsequent BPL instruction does not lead to another 
branch and the processor reaches the subroutine OPLEN. This subroutine 
is almost identical to the LENACC subroutine described in Book |. The 
OPLEN subroutine calculates the length of the instruction from the 
opcode that the display pointer CURAD is pointing to. After returning 
from OPLEN the length of the instruction to be displayed will be stored 
in the RAM location BYTES (@@F6). 

Once the length of the instruction is known, the processor can determine 
whether it should only display the contents of POINTH, the contents of 
POINTH and POINTL or the contents of POINTH, POINTL and INH. 

As mentioned previously, the subroutine SCAND fooks after the scanning 
of the keyboard and the multiplexing of the display. The subroutine 
SCANDS is also familiar to us from chapter 7, for it is the subroutine 
SCAND minus the first program section. In that section of program the 
display buffer INH is loaded with the contents of the memory location 
being indicated by the address pointers POINTH and POINTL. The 
processor does not require this particular section in the editor mode. Since 
SCANDS and the associated subroutines were all described in chapter 7, 
there is no need to go into them again. You can always refer back to that 
chapter to refresh your memory. 

Once the subroutine OPLEN has been completed the processor moves on 
to label SCANA. This section of the program up to the final (RTS) instruc- 
tion has also been described in chapter 7. Just to recap, this section of 
the program waits for a key to be depressed, debounces the depressed 
key and finally calculates the values of the key via the subroutine 
GETKEY. Upon the return from GETKEY the value of the depressed key 
will be held in the accumulator. The editor command keys have the 
following values: 

SEARCH : keyvalue 14 (same as the PC key) 

INSERT : keyvalue1@ (same as the AD key) 

INPUT : keyvalue13 (same as the GO key) 

SKIP : keyvalue 12 (same as the + key) 

DELETE : keyvalue11 (sameas the DA key). 

The testing of the various keys is accomplished with the aid of a CMP 
instruction followed by a BNE instruction. When a command key is 
detected, the processor will not branch at the next BNE instruction and 
the computer will concentrate on dealing with the particular task per- 
taining to the depressed key (see figures 4 and 5). 


Reporting an error 
EEEEEE! 


In the event of an operational error, the program section following the 
label ERRA in figure 5 will be executed. We have already discussed the 
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possible causes of an error report. The first group of instructions in this 
section of the program simply enters the hexadecimal value FF into the 
three display buffers POINTH, POINTL and INH. The memory location 
BYTES is then loaded with the value 03, as when an error is reported all 
six digits of the display must be enabled. The program section continuing 
on from label ERRB consists of a wait loop where the keyboard and dis- 
play subroutine, SCANDS, is executed. The display will continue to show 
EEEEEE until the key which caused the error to be reported is released. 
Once this has been done the processor will jump back to the central label 
CMND. 


The SEARCH routine 


As would be expected, whenever the SEARCH key is depressed the 

routine labelled SEARCH is executed (see figure 5). We already know that 

the value of the depressed key is held in the accumulator when the pro- 

cessor returns from the SCAN routine. The computer then determines 

whether the SEARCH key was depressed with the aid of two instructions 

immediately following the SEARCH label (CMP # 14, BNE). The program 

section pertaining to the SEARCH function has to meet the following 

requirements: 

1. It must be able to trace any two-byte pattern situated anywhere in the 
file. 

2. The search should start at BEGAD and end as soon as the required bit 
pattern has been found. 

3. If the required two-byte pattern can not be traced between BEGAD 
and CEND, the computer must report an error. 

The SEARCH routine starts by calling the subroutine GETBYT twice. 

Although this subroutine is familiar to us from Book I, the finer details 

have yet to be discussed. 


The subroutine GETBYT 


The detailed flowchart of the GETBYT subroutine is given in figure 9. 
Its task is to combine the values of two depressed data keys into a single 
byte and hold the result in the accumulator. This subroutine will only 
accept hexadecimal keys and will ignore command keys. 

The values of the two depressed keys are stored as one byte in the accumu- 
lator by shifting the value of the first one into the four most significant 
bits of the accumulator and ORing it with the value of the second. At the 
beginning of the GETBYT routine, the subroutine SCANA is called up. 
This is the second section of the subroutine SCAN iilustrated in figure 8, 
which a. establishes whether the old key has been released; b. establishes 
whether a new key has been depressed; c. calculates the value of the new 
key. 

Command keys have a value of 1 or higher, whereas hexadecimal keys 
have a maximum value of @F. Therefore, the two instructions (CMP # 19, 
BPL) at the start of the GETBYT routine determine which type of key 
was depressed. If a command key was depressed, the value of the N flag 
will be zero and the processor will branch back to the SEARCH routine 
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Figure 9. The subroutine GETBYT combines the values of two depressed keys into 
a single byte and holds the result in the accumulator. 


via the RTS instruction. if, on the other hand, a hexadecimal key was 
depressed, the processor will return from SCANA with the value of that 
key stored in the accumulator. If this was the first data key, the contents 
of the accumulator will be changed from @x to x@ (where x denotes the 
value of the depressed key) after the four shift operations (ASL-A). This 
value is then stored in the temporary location NIBBLE (@@FE). 

{n order to read the second data key the subroutine SCANA is called once 
more. (This is why the contents of the accumulator were saved before- 
hand). When the processor returns from SCANA the second time a further 
test is carried out (CMP#190, BPL) to determine whether the second de- 
pressed key is a command key or a hexadecimal key. In the case of the 
latter, the routine will ignore it and the processor will again branch back 
to the SEARCH routine. 
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If the second key happens to be a data key, with an assumed value of @y, 
the data byte in the accumulator will become xy after the instruction 
ORAZ-NIBBLE. Here x represents the value of the first hexadecimal key 
and y represents the value of the second data key. The final instruction 
in the GETBYT subroutine loads the value FF into the X index register, 
which sets the N flag. Now it can easily be determined whether a command 
key or a data key was depressed during GETBYT by examining the N 
flag. 

It should be added at this point that the subroutine GETBYT is very 
versatile. The programmer will soon see just how easily this subroutine can 
be incorporated into his/her own programs. 

Now to get back to the SEARCH routine shown in figure 5. After the sub- 
routine GETBYT is called the first time, the N flag is tested to see whether 
a command key was depressed. This lets the computer know whether or 
not to branch back to the label SEARCH by way of the BPL instruction. 

If two data keys were depressed during the GETBYT subroutine, they will 
both form the part of the two-byte pattern to be searched for. This will 
then be transferred to the display buffer POINTH and will be displayed 
the second time that GETBYT is called. While the computer is servicing 
the GETBYT routine the second time it will wait for the remaining half of 
the two-byte pattern to be entered. If, during this routine, a command key 
is depressed, the processor will once again branch back to SEARCH and 
will wait for a completely new two-byte pattern to be keyed in. 

However, if two data keys are depressed, they will constitute the second 
half of the bit pattern to be looked for. The combined value of these two 
keys will then be stored in the display buffer POINTL. This means that the 
two display buffers, POINTH and POINTL, have become the temporary 
storage locations for the particular two-byte pattern to be traced. 

At this stage the processor knows what pattern to look for between the 
labels BEGAD and CEND and the search can commence. To start with, 
the subroutine BEGIN is called, which makes the contents of pointer 
CURAD equal to those of BEGAD. The following section of the 
program, starting at label SELOOP, is executed until the required bit 
pattern turns up in the file. Once this has occurred, the processor will 
branch back to the central point CMND and the pattern will appear on the 
display during the following subroutine SCAN. Should the pattern in ques- 
tion prove to be non-existent, the processor will branch from SELOOP to 
label ERRA to report an error. 


The search 


How is the search for the particular two-byte pattern carried out? What 
happens is that the processor compares all the instructions and labels in 
the file to the bit pattern stored in the two display buffers POINTH and 
POINTL. 

The section of program concerned commences at label SELOOP. Here 
the contents of the Y index register are made to equal 90. During this 
routine the Y register is used as an index to access the various instructions 
and/or labels contained in the file. The accumulator is then loaded with 
the contents of the location indicated by the current address pointer 
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(CURAD) and compared with the contents of the display buffer POINTH. 
If the contents of POINTH are not equal to the opcode or label identifier 
pointed to by CURAD, then the length of the instruction (or jabel) must 
be calculated and the current address pointer updated accordingly. This is 
accomplished by the subroutines OPLEN and NEXT respectively. During 
the subroutine OPLEN address location BYTES is loaded with the length 
of the instruction pointed to by CURAD. During the subroutine NEXT 
(see figure 19) the contents of BYTES are added to the contents of 
CURAD and a check is made to see whether the value of CURAD is 
already greater than the value of CEND. I this is so, the processor will 
branch to ERRA to report an error. This will indicate that the bit pattern — 
being searched for does not exist in the file. 

if the contents of POINTH are equal to the opcode or label identifier 
pointed to by CURAD, the contents of the Y index register are 
incremented by one. Then the contents of the location indicated by 
CURAD +1 is compared to the contents of the display buffer POINTL. 
Should the data contained in the address location pointed to by 
CURAD + 1 be equal to that contained in POINTL, then the required bit 
pattern will have been found. The processor will then branch back to 
CMND to display the bit pattern. Thus, the SEARCH function allows 
labels or instructions of any length to be tracked down anywhere in the 
file. 

If the contents of POINTL are not equal to the contents of the location 
indicated by CURAD + 1, the search must continue. Once again the length 
of the label or instruction is determined by the subroutine OPLEN and 
the contents of the current address pointer updated accordingly. Provided 
the contents of CURAD are less than those of CEND the processor will 
branch back to SELOOP to continue the search for the required bit 
pattern. 

Thus, the SEARCH function compares two pairs of bytes with each other. 
The two stored in POINTH and POINTL are compared to those stored in 
the locations indicated by CURAD and CURAD + 1 respectively. In the 
subroutine NEXT the CURAD pointer is updated so that it now points to 
the location containing the next byte of the instruction (or label number) 
to be examined. Although what happens during the NEXT subroutine 
should be perfectly clear, it may be a good idea to examine the details 
a bit closer. 


The subroutine NEXT 


The detailed flowchart of the NEXT subroutine is given in figure 10. After 
the carry flag has been reset, the low order byte of the CURAD pointer is 
increased by the value contained in location BYTES. The fatter location 
contains the length of the instruction currently on display. Following this 
the value @@ plus the contents of the carry flag are added to the high order 
byte of CURAD. This ensures that the 16 bit addition of CURAD + 
BYTES results in the pointer indicating the next instruction (or label) to 
be examined. 

The second part of the NEXT subroutine is devoted to testing whether or 
not the current address pointer has exceeded the file boundary imposed by 
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Figure 10. The NEXT subroutine moves the current address pointer down the file 
by the number of memory locations contained in location BYTES. In addition, it 
checks whether the CURAD pointer is greater than the CEND pointer. 


the contents of the current end address pointer (CEND). This involves a 16 
bit subtraction, which is virtually the opposite of the previous addition. 
Firstly, the carry flag is set. Then the low order byte of CEND is subtracted 
from the low order byte of CURAD. Finally, the high order byte of CEND 
is subtracted from the high order byte of CURAD. The result of the 
complete subtraction will affect the N flag in the status register. If, after 
the return instruction, the N flag is reset (N = @), the contents of CURAD 
are greater than those of CEND and the processor must report an error. If, 
however, the N flag is set (N = 1), the contents of CURAD are less than 
those of CEND and ail is well. The processor will then return to SELOOP 
and continue the search. The state of the N flag is tested upon the return 
from NEXT with the aid of a BMI (Branch if Minus} instruction which 
causes the processor to branch back to SELOOP if the N flag is set. If the 
N flag is not set it must be reset and therefore the BPL instruction directs 
the processor to ERRA. 


The INSERT routine 


To understand how the INSERT routine works we need to go back to 
figure 5, the editor flowchart, once more. The first two instructions 
(CMP #1 and BNE) determine whether or not the INSERT key was 
depressed. If the computer returns from the SCAN routine with the value 
1@ in the accumulator, the INSERT key will have been depressed and the 
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INSERT function must be carried out. The INSERT routine performs the 

following task: 

1. It reads an instruction entered from the keyboard and places it in the 
display buffer. At the same time, the length of the instruction is 
determined. 

2. Once the entire instruction has been entered into the display buffer, it 
must be copied into the work memory immediately before the instruc- 

tion currently on display. This obviously involves moving the remainder of 

the file downwards by the corresponding number of bytes. 

Two subroutines have been provided in the editor program to meet the 

above requirements: the subroutine RDINST (= ReaD INSTruction) and 

FILLWS (= FILL Work Space). What exactly do these subroutines do? 


The subroutine RDINST 


The detailed flowchart of the RDINST subroutine is given in figure 11. 
The purpose of this subroutine is to enter a one, two or three byte instruc- 
tion into the display buffer of the computer. it starts by calling up another 
subroutine, GETBYT. This, as we know, enables two hexadecimal keys 
to be read into the computer. These will correspond to the opcode of the 
instruction to be entered. Upon the return from GETBYT, the opcode will 
be held in the accumulator and from there will be transferred into the 
display buffer POINTH. !f the programmer depressed a command key 
during the GETBYT routine, the processor will return to the editor main 
on in the usual manner with the N flag in the status register reset 
N= 9). 
Once the opcode of the instruction has been transferred to POINTH, the 
processor is able to determine the length of the instruction. For this 
purpose, the subroutine LENACC is called, which is part of the subroutine 
OPLEN we mentioned before. (These two subroutines will be discussed 
in greater detail towards the end of this chapter). Once the length of the 
instruction has been obtained, it is stored in three memory locations: 
BYTES, COUNT and TEMPX. 
After decrementing memory location COUNT, the processor tests to see 
whether the opcode is followed by any operand bytes which are also to be 
read into the display buffer. If the instruction is only one byte long, the 
processor will branch to the label RDA where the X index register is 
loaded with the value FF. This instruction causes the N flag to be set. 
If the computer returns from the subroutine RDINST with the N flag set, 
the entire instruction will have been entered into the display buffer. This 
can now be copied into the work memory in front of the instruction 
previously on display. 
If the processor returns to the editor main program from the subroutine 
RDINST with the N flag reset, the programmer must have depressed a 
command key when entering the instruction. Part of the instruction will 
now be in the display buffer, but this must not be transferred to the com- 
puter work memory. 
By setting or resetting the N flag during the subroutine RDINST the pro- 
cessor is able to check on its return to the main editor routine whether the 
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Figure 11. The RDINST subroutine enters an instruction from the keyboard into the 
display buffers. 
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entered instruction is to be copied from the display buffer into the file, or 
whether the computer should deal with the new command function. 

Now then, back to what happens when an instruction of more than one 
byte is read in. If after the first time the contents of memory location 
COUNT are decremented they are not equal to zero, the instruction will 
either be two or three bytes long. For this reason the subroutine GETBYT 
is called once more, during which the first operand byte of the instruc- 
tion is read into the accumulator. This is then stored in the display buffer 
POINTL after which the contents of location COUNT are again 
decremented. If this becomes equal to zero at this point, the instruction 
to be entered will be two bytes long and the processor will return to the 
editor main routine with the N flag set. If, however, the contents of 
COUNT are still not equal to zero, the instruction concerned will be three 
bytes long. The subroutine GETBYT will, therefore, be called a third time. 
The processor is then able to read in the second operand byte of the 
instruction. Once this is accomplished, it is stored in the display buffer 
INH. The processor then returns to the main editor routine with the N 
flag set. 

Upon the return from the RDINST subroutine the state of the N flag is 
tested with the aid of the BPL instruction, which causes a branch to 
SEARCH if the N flag is reset. If the N flag is set at this point in the 
INSERT routine the processor is directed to the subroutine FILLWS. 


Subroutines FILLWS and ADCEND 


The task of the FILLWS subroutine is to transfer the contents of the 
display buffers into the computer file and update the current end address 
pointer CEND. The latter is in fact accomplished during the subroutine 
ADCEND — more about this later. 

The detailed flowchart of the FILLWS subroutine is shown in figure 12. 
At the beginning of this routine the subroutine DOWN is called (see figure 
15). The DOWN subroutine will come up for discussion later as it is a 
relatively complicated subroutine. For the moment it ts sufficient to 
know that the DOWN subroutine makes space available in the computer 
work memory for the new instruction to be inserted. We already know 
that the current address pointer, CURAD, indicates the address of the 
instruction currently on display. Since a new instruction can be one, two 
or three bytes long and must be inserted before the instruction shown, 
the subroutine DOWN must move the entire data block between CURAD 
and CEND down by the corresponding number of bytes. As soon as space 
has been made, the new instruction can be copied from the display buffer 
into the file. 

Prior to the subroutine FILLWS being called (see figure 5), the processor 
will have calculated the length of the instruction and stored the result in 
location BYTES. When the processor jumps from FILLWS to DOWN, the 
data biock between the pointers CURAD and CEND is then moved down 
by the number of memory locations contained in BYTES. If, for instance, 
the entered instruction is two bytes long, the hexadecimal number 2 will 
be contained in location BYTES. The subroutine DOWN will then move 
the block of data between the pointer CURAD and CEND down by two 
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POINTL : GOFA 
POINTH : O0FB noniaaas 


Figure 12. The subroutine FILLWS makes room for a new instruction to be copied 
from the display buffers into the file. 


memory locations. 

It should now be fairly clear how the subroutine DOWN helps to make 
room for a new instruction to be copied from the display buffer into the 
file. Upon returning to the subroutine FILLWS (figure 12), the next stage 
is to update the current end address pointer, CEND. This is the task for 
the subroutine ADCEND (= ADvance Current END address pointer = 
move CEND pointer down by the value of BYTES). The detailed flow- 
chart of the ADCEND subroutine is given in figure 13. This routine 
simply adds the contents of location BYTES to the address pointed to 
by CEND. The 16 bit addition is performed in exactly the same way as for 
CURAD in the NEXT subroutine. Firstly, the carry flag is cleared. The 
value contained in location BYTES is then added. to the low order byte of 
CEND. Finally, the value 00 plus the contents of the carry flag are added 
to the high order byte of CEND. 
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(c = @ or 1) 
STAZ — CENDL 


LDAZ — CENDH 


ADC #46 CENDH < CENDH +c 


Cc 
- LDAZ — CENDL 
ADCZ — BYTES CENDL <CENDL + BYTES 
STAZ — CENDH 


CEND <CEND + BYTES 
80915-8-13 





Figure 13. The ADCEND subroutine is called by the subroutine FILLWS (figure 12). 
Its function is to increase the value of CEND by the contents of location BYTES — 
move the CEND pointer down by the number of bytes corresponding to the length 
of the new instruction. 


As soon as the processor returns from the ADCEND subroutine, the X 
index register is loaded with the value @2 and the Y index register with the 
value @@. The process that follows, after the label WS, simply copies 
the contents of the display buffers into the file starting from CURAD and 
ending when the value in the Y index register is equal to that of BYTES. 
Both pre-indexed and post-indexed indirect addressing are used in this 
section of the program. The procedure can be summarised as follows: 
1. The contents of INH + @2 (= POINTH = the opcode of the instruction 
to be entered) are transferred to the contents of CURAD + @@ (X = @2, 
Y = 60). The contents of the X index register are then decremented and 
those of the Y index register are incremented. The value in the Y index 
register is then compared with the contents of BYTES to check whether 
there are any further operand bytes to be transferred. If there are: 
2. The contents of INH = @1 (= POINTL = the first operand byte of the 
instruction to be entered) are transferred to the contents of 
CURAD + 61 (X= 61, Y = 01). Again, the contents of the X index register 
are decremented and those of the Y index register incremented. Then the 
value contained in the Y index register is once more compared to the con- 
tents of location BYTES to check whether a further operand byte is to be 
transferred. If so: 
3. The contents of INH + @@ (= 1NH =the second operand byte of the 
instruction to be entered) are transferred to the contents of 
CURAD + @2 (X = 00, Y = 02). The contents of the X index register are 
again decremented and those of the Y index register incremented. When 
the contents of the Y index register are compared to those of location 
BYTES this time they will have to be equal as the contents of BYTES 
can not exceed 93. This means that the processor will not effect a branch 
this time, but will continue to the return instruction. 
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Once the contents of all the display buffers have been inserted into the file 
between CURAD and CEND, the processor will leave the FILLWS routine 
and go back to the INSERT routine (see figure 5). The Z flag will always 
be set at this stage and so at the end of the INSERT routine the processor 
branches back to the central point CMND via a BEO instruction. The 
editor will then continue to wait for a new command key to be entered. 


The INPUT routine 


The INPUT routine is very similar to the INSERT routine, therefore, apart 
from a few minor differences which we'll examine here. The purpose of 
the routine was explained in chapter 5 and is: to read in a new instruction 
from the keyboard into the display buffer and copy the new instruction 
into the file immediately after the one currently on display. 

The INPUT routine is also illustrated in figure 5. The first two instructions 
(CMP #13 and BNE) determine whether or not the INPUT key was de- 
pressed. If so, the subroutine RDINST is executed which, as we Know, 
reads an instruction entered from the keyboard and copies it into the 
display buffer. If a command key is depressed during this subroutine, the 
processor will branch back to the central label CMND via the following 
BPL instruction. 

If, on the other hand, the entire instruction has been entered, the sub- 
routine OPLEN will be called. At this moment the current address pointer 
will still be pointing to the ‘old’ instruction in the file. The computer then 
determines the length of this instruction with the aid of the OPLEN 
subroutine. Following this the subroutine NEXT is called, which moves 
the current address pointer, CURAD, down by the equivalent number of 
bytes to the length of the old instruction shown on the display. 

The pointer CURAD will now indicate the address where the new instruc- 
tion should be stored in the file. After the return from the NEXT sub- 
routine, the contents of location TEMPX are transferred to location 
BYTES. As you know, the contents of location BYTES represent the 
length of an instruction. What, however, does the location TEMPX con- 
tain? To find out, let us reconsider part of the RDINST subroutine 
(figure 11). During this subroutine the instruction length information is 
stored in location TEMPX after the return from LENACC. The processor 
uses this information in the INPUT subroutine before jumping to the 
FILLWS subroutine. During the latter routine the new instruction is 
inserted immediately after the old one. As the current address pointer, 
CURAD, has not altered since the NEXT subroutine, it will already be 
pointing to the newly entered instruction upon the processor’s return to 
the central CMND point. The SCAN subroutine proceeds to display the 
new instruction and the computer will wait for a further command key to 
be depressed. 


The SKIP routine 


The purpose of the SKIP subroutine (as mentioned in chapter 5) is to 
check through a program that has been entered with the aid of the editor. 
The SKIP function simply steps through the entered program one com- 
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plete instruction at a time whenever the SKIP key is depressed. The entire 
instruction, be it one, two or three bytes long, will appear on the display. 
Once more, the detailed flowchart of the SKIP subroutine is shown in 
figure 5. 

The two initial instructions (CMP #12 and BNE) determine whether or not 
the SKIP key was depressed. If so, the only thing to be altered is the 
position of the current address pointer, CURAD. We already know which 
subroutine moves the CURAD pointer down by one, two or three bytes: 
the NEXT subroutine (figure 10). 

During this subroutine the processor checks to see whether the CURAD 
pointer has already exceeded the current end address pointer, CEND. If 
so, an error will have to be reported. The program will branch to label 
ERRA via the BPL instruction. The display will show the ‘message’ 
EEEEEE until the SKIP key has been released. Otherwise the processor 
will branch back to the central CMND label via the BMI instruction and 
the processor will wait for the next command key to be depressed. 


The DELETE routine 


The final command key routine of figure 5 to be described is the DELETE 
routine. As we know from chapter 5, its purpose is to erase a particular 
instruction from the computer memory. The DELETE function has to 
effectively move the complete data block starting at the instruction 
immediately following the one currently on display and ending at the 
pointer CEND up by one, two or three bytes. The actual number of bytes 
the block is moved up depends on the length of the instruction to be 
erased (the one currently on display). As a result of the data block being 
moved up, the current instruction will be overwritten. 

As can be seen from the detailed flowchart in figure 5, the DELETE key 
is detected in the usual manner (with the aid of the instructions CMP # 11 
and BNE). Once the DELETE key has been depressed, the processor 
jumps to the subroutine UP. As expected, this is the subroutine which 
moves the data block up by the required number of bytes. (This sub- 
routine will be described in detail later). 

Since deleting an instruction will cause the file to be shortened by one, 
two or three memory locations, the current end address pointer CEND will 
also have to be shifted upwards. This is accomplished by the subroutine 
RECEND (= REduce Current END address = move CEND pointer up by 
value of BYTES). The detailed flowchart of the RECEND subroutine is 
shown in figure 14. It simply performs a 16 bit subtraction. In fact, it is 
the exact opposite of the subroutine ADCEND shown in figure 13 ( the 
16 bit addition). The operation of the RECEND subroutine should hardly 
need explaining by now. All that happens is that the contents of address 
location BYTES are subtracted from the contents of the current end 
address pointer CEND. When the processor returns from the RECEND 
routine a jump is made back to the central label CMND where the com- 
puter once again waits for a new command key to be depressed. 

This completes the description of ali five command routines contained in 
the editor program. However, three subroutines were only mentioned 
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Figure 14. The subroutine RECEND is the opposite of ADCEND (figure 13). Its 
function is to decrease the value of CEND by the contents of location BYTES — 
move the CEND pointer up by the number of bytes corresponding to the length of 
the instruction to be erased. 


briefly and it is time to examine these in greater detail. The three sub- 
routines in question are: DOWN, UP and OP LEN/LENACC. 


The subroutine DOWN 


As mentioned previously, the DOWN subroutine is called by the FILLWS 
subroutine. The latter was used for the INSERT and INPUT functions, 
when space for the new instructions had to be made in the file. In other 
words, the processor had to move a data block down by one, two or three 
bytes depending on the length of the instruction to be entered. Essentially, 
this is the task of the DOWN subroutine. The detailed flowchart of the 
DOWN subroutine is shown in figure 15, while the operation is illustrated 
in figure 16. 

During the DOWN subroutine the processor makes use of a new address 
pointer MOVAD (= MOVe ADdress). This pointer will always indicate a 
byte in the file that is to be moved down by one, two or three memory 
locations. The first four instructions in the DOWN subroutine therefore 
make the contents of MOVAD equal to those of CEND. The move address 
pointer will indicate the same address location as the CEND pointer, which 
is the memory location following the EOF character 77, 

By now the processor has reached the label DNLOOP. This is where the 
actual moving of the data block takes place. Firstly, the value contained 
in the Y index register is made equal to zero. The contents of the address 
location indicated by the MOVAD pointer are then loaded into the 
accumulator (Y = 00). The contents of location BYTES are then trans- 
ferred to the Y index register. The value in the accumulator is then stored 
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Figure 15. The DOWN subroutine shifts a data block in the file down by one, two or 
three memory locations. This makes room for a new instruction to be copied from 
the display buffer. 
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BYTES = @3 


80915-8-16 





Figure 16. The operation of the DOWN subroutine. In the given example the data 
block is moved down three places as the contents of memory location BYTES 
equals 03. | 


in the address location indicated by the MOVAD pointer plus location 
BYTES (Y = BYTES). 

Subsequently, a comparison is made between the two pointers CURAD 
and MOVAD. If the pointer MOVAD is not equal in value to that of 
CURAD, there are more bytes to be moved down in the file. The processor 
will then decrement the value of the pointer MOVAD after the label 
DNA, meaning that MOVAD wiil move up one memory location in the 
file. After jumping back to the label DN LOOP the processor will also move 
the data byte pointed to by MOVAD down by the number of locations 
indicated by the value contained in location BYTES. Thus, the procedure 
described above is repeated until the two pointers MOVAD and CURAD 
are equal. Once this is so, all the bytes in the data block will have been 
moved down in the file by the requisite number of memory locations. The 
processor is then able to insert the new instruction in the (now) vacant 
space immediately following the address indicated by the pointer 
CURAD. 

A graphical representation of the way in which the DOWN subroutine 
operates is given in figure 16. The MOVAD pointer will always indicate the 
data byte to.be moved down in the file. After every ‘shift’ operation the 
processor will decrement the pointer MOVAD, so that it gradually moves 
up in the file. This means that its starting value will be equal to CEND 
and its final value will be equal to CURAD. In figure 16 the contents of 


162 


location BYTES are equal to 03. Therefore, three consecutive memory 
locations will be vacated (following CURAD) in which the new instruc- 
tion can be entered. 

In the standard version of the Junior Computer a file will be no longer 
than 512 bytes. Such short files will only require the use of the DOWN 
subroutine for very brief periods, since few data bytes are to be shifted. 
When the computer is expanded, however, a file cou'd well be two to four 
kilobytes long. If an instruction is to be entered near the beginning of such 
a long file via the INSERT or INPUT routines, the Junior Computer will 
spend several seconds in the DOWN subroutine. This can be seen on the 
display which will go dark for some time! 


The subroutine UP 


The UP subroutine is the reverse of the DOWN subroutine and, as we 
know, is called during the DELETE function. The latter is used to erase 
certain instructions from the file. This means that the data block in the 
file will have to be shifted up by one, two or three bytes, depending on 
the length of the instruction to be deleted, to compensate for the erasure. 
This is, of course, the task of the UP subroutine. The detailed flowchart 
of the UP subroutine is given in figure 17, while the operation is illustrated 
in figure 18. 

The address pointer MOVAD is again made use of during the UP sub- 
routine. Again, this pointer will indicate the byte in the file that is to be 
repositioned. The first four instructions in the UP subroutine therefore 
make the contents of MOVAD equal to those of CURAD. Whereas the 
DOWN subroutine started the transfer from the bottom of the file, the UP 
subroutine starts at the top. 

By now, the processor will have arrived at the label UPLOOP. This is 
where the actual movement of the data block takes place. Firstly, the 
contents of location BYTES are loaded into the Y index register. The 
contents of the address location pointed to by MOVAD + BYTES is then 
loaded into the accumulator. The value in the Y index register is then 
made zero and the value in the accumulator stored in the address location 
indicated by MOVAD. The value of the move address pointer is then in- 
cremented so that it is ready for the next data byte location. If the low 
order byte of the MOVAD pointer is zero, the high order byte will also 
have to be incremented. 

This brings us to label UPA. From here on the processor simply determines 
whether or not the contents of the move address pointer have exceeded the 
value of the current end address pointer. If not, the processor will branch 
back to label UPLOOP and move the next data byte in the file up by the 
number of spaces corresponding to the value held in location BYTES 
until such time as the two pointers (MOVAD and CEND) are equal. 

Once this is so, all the bytes in data block will have been moved up in the 
file by the requisite number of memory locations. The processor will 
then have overwritten the instruction previously on display thereby 
deleting it from the file. 

Little needs to be said about the graphical representation of the UP 
subroutine (see figure 18) as it is virtually identical to that of the DOWN 
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Figure 17. The UP subroutine is the reverse of the DOWN subroutine in that it 
shifts a data block in the file UP by one, two or three memory locations. This enables 
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Figure 18. The operation of the UP subroutine. In the given example the data block 
is moved up three places as the contents of location BYTES equals @3. 


subroutine (figure 16) — albeit in reverse. Again, the contents of location 
BYTES are 03. Initially, the MOVAD pointer and the CURAD pointer 
are equal. The MOVAD pointer always indicates the address of the data 
byte to be moved up three places in the file. After every shift operation 
the processor will increment the contents of the MOVAD pointer, so that 
it gradually moves down the file. This means that its starting value will be 
equal to CURAD and its final value will be equal to CEND. 


The subroutine OPLEN/LENACC 


Part of the OPLEN subroutine should be familiar to us from Book I, 
chapter 4: the subroutine LENACC. During this subroutine the processor 
calculates the length of an instruction. Before LENACC can be called the 
instruction opcode must be held in the accumulator, for without the 
opcode the length of the instruction can not be calculated. When the sub- 
routine OPLEN is called, therefore, the instruction indicated by the 
address pointer CURAD is (automatically) entered into the accumulator. 
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Figure 19. The OPLEN subroutine calculates the length of a particular instruction, 
the opcode of which is indicated by the current address pointer. The actual 
calculation starts after the label LENACC. 
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The detailed flowchart of the OPLEN subroutine is given in figure 19. 
There is a slight difference between the LENACC section of the subroutine 
described in Book |, chapter 4, page 132, and the LENACC subroutine as 
contained in the EPROM of the Junior Computer. The two index registers 
(X and Y) have been interchanged — this has no effect on the operation of 
the routine. 

As you will remember from Book I, the lengths of the various 6502 micro- 
processor instructions can be determined from a look-up table. This table 
was previously called LENTBL, but is now called, quite simply, LEN (see 
table 1). 


Table 1 LEN 
1F1F @2 X=@@: column@ = (mainly 2 byte instructions) 
1F2@ 02 X=G@1; column1_ (only 2 byte instructions) 
1-21 @2 X=62; column2 (LDX IMM) 
1F22 61 X=6@3; coiumn3 {empty ‘1 byte instruction’) 
1F23. @2 X=@4; column4 (mainly 2 byte instructions) 
1F24 92 X=@5; column5 (only 2 byte instructions) 
1F25 @2 X=@6; column6 (only 2 byte instructions) 
1F26 @1 X=67; column7_ (EOF character ‘1 byte instruction’) 
1F27 @1 X=@8; column8 (only 7 byte instructions) 
1F28 @2 X=6@9; column9 (mainly 2 byte instructions) 
1F29. @1 X=G@A; columnA (mainly 1 byte instructions) 
1F2A 01 X=0B; columnB (empty ‘1 byte instructions’) 
1F2B @3 X=6@C; columnC (mainly 3 byte instructions) 
1F2C @3 X=6D; columnD (only 3 byte instructions) - 
1F2D @3 X=@QE; column E (mainly 3 byte instructions) 
1F2E @3 X=G6F; columnF (label FF ‘3 byte instruction’) 


The look-up table , LEN, was compiled with the aid of the condensed 
instruction code table shown in figure 20 (this can also be found on pages 
130 and 131 of Book |). Note that columns 7 and F are no longer empty. 
They contain the EOF character 77 and the label identifier FF respect- 
ively. Full details of this table and the LENACC subroutine were given in 
Book I, therefore there is no need to describe them fully here. However, 
since the subroutine OPLEN/LENACC is used quite often, a summary of 
the main points would not be amiss: 
1. After the subroutine OPLEN is called, the accumulator ts loaded with 
the opcode of the instruction which is being pointed to by the current 
address pointer CURAD. This pointer will indicate a normal instruction 
opcode, the label identifier (pseudo-opcode) FF or the EOF character 
77. | 
2. From LENACC on, the Y index register is loaded with @1 and the 
instructions BRK, RT! and RTS (single byte instructions) are filtered 
out with the relative compare instructions, If the opcode of one of these 
three instructions is held in the accumulator, the contents of the Y index 
register (01) will be stored in location BYTES (= instruction length). 
3. The next instruction to be filtered out is the JSR instruction. As this 
instruction is three bytes long, the Y index register is first loaded with 
03. The following compare and branch instructions direct the processor 
to store the value @3 (Y register) in location BYTES if the opcode held in 
the accumulator is that of the JSR instruction. 
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most significant four bits 


‘most significant four bits 


0 
7 

2 
3 
4 
5 
6 
7 

8 
9 
A 
B 
Cc 
D 
E 
F 


ORA {IND,Xx) 
ORA (IND),Y 
AND (IND,X) 
AND (IND), Y 
EOR (IND,X) 
EOR (IND), 
ADC (IND,X) 
ADC (IND),Y 
STA {iND,X) 
STA (IND},Y 
LDA (IND,X) 
LDA (tND},Y 
CMP (IND,X) 
CMP (IND),¥ 
SBC {IND,X) 
SBC (IND), Y 


(2} 
(2) 
(2) 
(2) 


least significant four bits 





BIT Z (2} 


STYZ {2) 
STY Z,X (2) 
tOYZ = =(2) 
LDY Z,X (2) 
cPYZ = (2) 


CPXZ (2) 


ORAZ (2} 
ORA Z,X (2) 
ANB Z = (2) 
AND Z,X (2) 
EORZ = {2} 
EOR Z,X {2} 
ADC Z = {2} 
ADC Z,X (2} 
STAZ (2) 
STAZ,X (2) 
LDAZ (2) 
LDA Z,X (2) 
CMP 2 (2) 
CMP Z,X (2) 
SBCZ = (2) 
SBC Z,X_ {2} 


ASLZ (2) 
ASL Z,X (2) 
ROL Z (2) 
ROL Z,X (2} 
LSRZ = (2) 
LSRZ,X (2) 
ROR Z = (2) 
ROR Z,X (2) 
STX2Z = (2) 
STX Z,¥ (2) 
LDxZ = (2) 
LDX 2Z,Y (2) 
DECZ (2) 
DEC Z,X {2} 
INC Z (2) 
INC Z,X {2} 





least significant four bits 


ORA# {2} 
ORA ABS,Y {3} 
AND # (2) 
AND ABS,Y (3} 
EOR # (2) 
EOR ABS,Y (3) 
ADC # (2) 
ADC ABS,Y (3) 


ASL ABS 
ASL ABS,X 
ROL ABS 
ROL A8S,X 
LSR ABS 
LSR ABS,X 
ROR ABS 
ROR ABS,X 
STX ABS 


BIT ABS 
JMP ABS 
JMP IND 


STY ABS 
STA ABS,Y (3) 
LDA # (2) 
LDA ABS,Y (3) 
CMP # (2) 
CMP ABS,Y (3) 
SBC # (2) 
SBC ABS,Y (3) 


LOY ABS {3} 
LDY ABS,X{3) 
CPY ABS (3) 


LOX ABS 
LDX A85S,Y 
DEC ABS 
DEC ABS,X 
INC ABS 
INC ABS,X 


CPX ABS (3) 
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Figure 20. Both the EOF character 77 and the label identifier FF have been included 
in the condensed instruction table. This table is used to compile the look-up table 
LEN (table 1). 


4. The next step in the OPLEN subroutine is to filter out all three byte 
instructions of column9 in figure 20. This is accomplished by 
masking the five least significant bits (AND #1F) and comparing the 
result with the value 19. If the opcode contained in the accumulator 
belongs to one of these instructions the value @3 (Y index register still 
contains 03) will be placed in location BYTES. 
9. Finally, if none of the above points apply, the length of the instruction 
must be obtained from the look-up table LEN. This is accomplished by 
masking the four least significant bits of the opcode (AND #90F) and 
transferring the result into the X index register. The Y index register 
is then loaded with the value obtained from the table, which is then 
transferred to location BYTES. 
We should now be totally familiar with the operation of the editor section 
of the monitor program. The various editor subroutines will prove to be 
a great heip to the programmer when developing future programs. The 
complete source listing pertaining to the editor can be found in the 
appendix to this book, 
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The Assembler program 


Tidying up the edited program 


Once a program has been entered into the Junior Computer by 
means of the editor routine, it has to be ‘reshaped’ into a form 
that the 6502 microprocessor can understand. This is the task 
of all the subroutines used by the assembler section of the 
monitor program. When a program is entered with the aid of 
the editor, the operand of a jump or branch instruction will 
usually be a label number, in other words, a symbolic address. 
Even the labels themselves are pseudo-instructions which the 
processor is unable to understand. For these reasons, the 
assembler must remove all labels from the program, replace 
the symbolic addresses of jump instructions with their ‘real’ 
addresses and replace the label numbers of branch instructions 
with their actual displacement values. This chapter therefore 
describes the way in which ail this is dealt with by the various 
subroutines used during the assembler program. 


Chapter 5 introduced us to the benefits to be derived from using the 
editor and the assembler. When entering a program with the aid of the 
editor it is no longer necessary to know the start addresses of the sub- 
routines to be called or the displacement values of the branch instruc- 
tions. For now we can use labels, or so-called symbolic instruc- 
tions. By using labels instead of actual addresses, the computer can be 
made to relieve us of a considerable amount of tedious calculations 
(what else are computers for?). Programs can be keyed in to the memory 
banks of the Junior Computer with the aid of the editor and without any 
difficulty. Once the program has been assembled we can be sure that all 
the subroutine start addresses and displacement values of branch instruc- 
tions are correct. This means that the time consuming job of stepping 
through programs to look for errors can be reduced to a swift, last minute 
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check. Another advantage is that the editor and assembler enable programs 
to be stored in the available memory as compactly as possible. 


The basic flowchart of the assembler 


It was mentioned in chapter 5 that the assembler contained in the monitor 
program of the Junior Computer is a ‘two pass’ assembler. This means that 
the actual assembly procedure is carried out in two stages. The basic flow- 
chart of the assembler is given in figures 1 and 2. In order to appreciate the 
two phases involved, the basic flowchart has been divided into two sec- 
tions. 

As the obvious place to start is at the beginning, let us first take a look at 
figure 1. The label ASSEMB (start address 1-51) heads a section of pro- 
gram which carries out all the necessary preparations before the actual 
assembler main routine can proceed. This involves setting the various 
address pointers to the correct positions. 

Next we come to label PASSA which is where the first phase of the main 
assembler program starts. Here, the processor will only concentrate on 
labels entered by the programmer with the aid of the editor, all other 
instructions will be ignored. How does the processor track down each 
of the labels? This is a relatively simply task. As we already know, the 
processor is able to determine the length of any given instruction with the 
aid of the OPLEN subroutine. We also know that the NEXT subroutine 
can be used to ‘skip’ from instruction to instruction. By combining these 
two subroutines the processor simply runs through the entire program 
(section) and examines the first byte of each instruction encountered. 

If a label is involved, the value of this first byte will be FF (the label 
identifier). The processor will then take note of the address which contains 
this pseudo-instruction. In addition, it will store the label number 
following the identifier. Both the address and the label number are stored 
in what is called the ‘symbol stack’. This is virtually nothing more than a 
scratch pad and can be compared to the computer’s normal stack situated 
on page 1. The only real difference between them is that the stack pointer 
is controlled by the microprocessor itself (hardware controlled) and the 
pointer belonging to the symbol stack is controlled by the program (soft- 
ware controlled). Nevertheless, they both have one thing in common and 
that is that they ‘expand’ upwards from the bottom. 

Now to get back to the first phase of the assembly process. Once the pro- 
cessor has found a label in the file and the address of the pseudo-instruc- 
tion together with the label number have been stored on the symbol 
stack, the label must be deleted from the file. The subroutine which takes 
care of this was introduced in the previous chapter, namely the UP sub- 
routine which was called during the DELETE function. Since a label is 
always three bytes long, the data block starting immediately after the 
label and ending at the address indicated by the CEND pointer will be 
moved up by three bytes. This deletes the label from the file which is now 
three bytes shorter. Obviously, the end address pointer, CEND, will now 
have to be readjusted so that is also moves up three places in the file. Now 
the opcode of the instruction following the deleted label will have moved 
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Figure 1. The basic flowchart of the first phase of the assembler. During this phase, 
the processor removes all the labels from the file and stores the label number and. 
its associated address on the symbol stack. 
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Figure 2. The basic flowchart of the second phase of the assembler. During this 
phase, the label number and limiter byte following jump instruction opcodes are 
replaced by the actual jump address. At the same time, the label number following 
a branch instruction is replaced by the actual displacement value. 
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to the address where the label identifier was situated previously. The above 
procedure is clearly illustrated in figures 3a and 3b. 
Once the label has been erased from the file and all the relevant infor- 
mation concerning it has been stored on the symbol stack, the processor 
will search for the next label. This means that the processor continues to 
jump from instruction to instruction while testing each one to see if the 
the first byte has the value FF. Whenever the label identifier, FF, is 
encountered, the same procedure takes place: 

1. The address location where the label identifier is found is stored on the 
symbol stack (first the high order byte followed by the low order byte). 

2. The label number following the identifier is obtained and is also stored 
on the symbol stack. This means that three important parameters 

concerning the label are stored on the symbol stack: the high and low 

order bytes of the address where it was found and the label number. The 
exact structure of the symbol stack will be discussed in detail later. 

3. The label is removed from the file. The instruction immediately follow- 
ing the label will now be located at the address where the label was 
previously. 

4. The file is examined for more labels and if none are found the process 
will be stopped. 

This procedure is also illustrated in figure 3. Four stages of a label search 
Operation during the first phase of assembly are shown. In figure 3a the 
processor encounters a label at address 0200. Once all the required details 
concerning the label have been stored on the symbol! stack, the label can 
be erased from the file. This situation is shown in figure 3b. As a label is 
always three bytes long, the data block following it has been shifted up 
three places. Thus the opcode of the instruction following the label will 
now be situated at the old address of the label. At the same time, the file 
will have become three bytes shorter. 

The processor then continues the search for another label, which it finds at 

address location @208. The required parameters are again stored on the 

symbol stack and the label is removed from the file (figure 3c). The next 
label will be found at address 0217 and the above procedure is repeated to 
produce the final result as shown in figure 3d. 

This covers just about all there is to say initially about the first phase of 

the assembly routine. Now it is time to take a look at the second phase 

(PASSB). As stated previously, the basic flowchart of the second phase 

of the assembler operation is shown in figure 2. By this time all the labels 

will have been removed from the file. After the label PASSB the processor 
will examine all the instructions remaining in the file, starting with the 
first one. However, the only instructions the processor is interested in are 
those referring to a label number. We know which instructions these are 

from chapter 5: 

* the JMP instruction with the opcode 4c 

the JSR instruction with the opcode 20 

“ the branch instructions BCC, BCS, BEQ, BMI, BNE, BPL, BVC and 
BVS. 

During the second assembly phase, the processor assigns the correct 

addresses and displacement values to the above instructions. For this 

reason the three different types of instruction are filtered out of the file 


* 
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Figure 3, Four stages of a label search operation during the first phase of the __ 
assembier. Each time a label is encountered in the file the following data block is 
shifted up three locations, after the label number and its address have been stored 


on the symbol stack. 
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one after the other. The processor is quite capable of determining the type 
of instruction from its opcode. If the processor encounters the opcode 4C 
(the JMP instruction) it ‘knows’ that there is a label number following. 
The address of the label was stored on the symbol stack together with the 
label number during the first phase of assembly (PASSA). 
The computer will now interrogate the symbol stack until it finds a 
jabel number identical! to the one following the opcode 4C. When this 
has been found, the processor will fetch the corresponding address from 
the symbol stack and place it behind the opcode 4C. The address consists 
of two bytes, therefore the label number and the limiter byte which were 
previously behind the opcode will now be replaced by the actual jump 
address in the process. The JMP instruction (with the opcode 4C) has 
now been assembled. 
The next instruction the computer checks for is the JSR instruction. If 
the computer comes across the opcode 2@ the symbol stack is once more 
interrogated for the address corresponding to the label number following 
the JSR instruction. As before, the processor places this address behind 
the instruction and thereby assembles it. The procedure is identical to that 
for the JMP instruction. 
As we know, the 6502 microprocessor features eight branch instructions. 
If the processor encounters the opcode of a branch instruction, the label 
number following it must be replaced by the actual displacement value. 
A branch instruction is assembled as follows: 
The processor checks to see which label number follows the opcode of 
the branch instruction. An absolute address corresponding to that label 
is stored in the symbol stack. 
The processor searches for the label number in the symbol stack. Once 
this has been found, the corresponding absolute address will also be 
known. 
The computer will now know the address containing the opcode of the 
branch instruction and the absolute address of the label number. From 
this the processor can calculate the required displacement value for the 
branch instruction. 

The processor places the displacement value it has calculated immedi- 

ately behind the branch instruction to be assembled. 
In certain instances the processor may come across a JMP, JSR or branch 
instruction that does not require assembly. As mentioned in chapter 5, 
there are certain times when the jump instruction refers to a particular 
address that is already known during editing. If this is the case, the instruc- 
tion will not be followed by the label number and the limiter byte 00. 
Also, the label will not have been stored in the symbol stack during the 
first phase of assembly as the label identifier FF will be absent. In other 
words, the label is non-existent in the file and so the processor was unable 
to store the label number and its corresponding absolute address on the 
symbol stack during PASSA. If the Junior Computer encounters such an 
instruction during the second phase of the assembly procedure, the instruc- 
tion will not be assembled. This means that no data is altered after the 
opcode. For the sake of clarity, the assembly block has been left out 
of figure 2. 
Up to now, we have discussed the general procedure during assembly. We 
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have discovered that the assembler processes the file produced by the 
editor in two stages. During the first phase the processor removes all the 
labels from the file and stores all the label numbers and associated ad- 
dresses on the symbol stack. During PASSA the processor is only 
interested in those instructions that start with the pseudo-opcode FF. 
Once all the labels have been deleted and all the label numbers and their 
absolute addresses have been stored on the symbol stack, the computer 
will start the second phase of the assembly operation (PASSB). 

During this second phase the processor is only interested in the opcodes 
AC, 20 and those belonging to the various branch instructions. These 
are still followed by label numbers {and in the case of the jump instruc- 
tions by the limiter bytes). The processor will then track down the label 
number situated behind the opcode of the instruction being assembled 
in the symbol stack. Each label number on the symbol stack has a corre- 
sponding absolute address, which will be placed in the file directly after 
the opcode as far as jump instructions are concerned. With respect to 
branch instructions, the processor will calculate the displacement value 
from this address. The organisation of the symbol stack still remains to be 
considered. Now that we know the basics of the assembly procedure, we 
can go in to it in greater detail and discover more about the symboi stack 
in the process. 


The detailed flowchart of the assembler 


The detailed flowchart of the assembler routine will again be discussed 
in two phases. The first phase of the assembler (PASSA) is shown in figure 
4. This is the section that deletes the labels from the file and stores their 
numbers and associated absolute addresses on the symbol stack. 

The assembler starts from the label ASSEMB at address location 1F51. 
During the first part of this program section the processor sets various 
address pointers and initialises the symbol stack. 

Before continuing with this description, a few general remarks should 
be made. The assembler program is closely related to the editor program, 
In other words, the assembler makes use of many of the subroutines used 
by the editor. For this reason, it would be useful to study chapter 8 again 
at this stage, if the way in which the editor subroutines operate is not fully 
understood. 

The assembler uses an address pointer that has not yet been mentioned, 
namely: TABLE. This is stored in address locations @BED and OMEC 
(TABLEH and TABLEL respectively). 

These two memory locations contain the address indicated by the TABLE 
pointer. This address pointer always indicates the highest address on the 
symbol stack. The lowest address will be TABLE + FF, meaning that the 
symbol stack is 256 bytes long. The first seven instructions following the 
label ASSEMB ensure that the address pointer TABLE is initially loaded 
with an address which is 256 (= FF) memory locations in front of the 
ENDAD (end address) pointer. This is also illustrated graphically in 
figure 5. 

Next, the assembler routine uses another new memory location called 
LABELS. This is situated at address @@EE. When the contents of LABELS 
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Figure 4. The detailed flowchart of the first phase of assembly. 
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CURADL : 00€6 
CURADH: @GE7 
LABELS : @@EE 
TABLEL : GGEC 
TABLEH : GGED 


Figure 5. The pointer TABLE + LABELS enables the processor to contro! the data 
transfer to or from the symbol stack. The symbol stack is ‘filled’ from bottom to 
top during the assembly process. First the labef numbers and then the contents of 
the current address pointer CURAD are stored on the stack. 


are added to those of the address pointer TABLE, the result will be the 
actual address to which the symbol stack pointer is directed at that mo- 
ment. This will therefore be equal to TABLE + LABELS. During the first 
phase of assembly the symbol! stack pointer will always indicate the first 
available vacant location in the symbol stack. If a label is found during 
this first phase of assembly, the label number will be stored in the first 
spare location of the symbol stack followed by the low order address 
byte in the next spare location followed by the high order address byte in 
the third spare location. 

By now it should be fairly clear as to how the symbol! stack is organised. 
Once all the pointers have been initialised, the symbol stack pointer will 
indicate the same address location as the ENDAD pointer (see figure 5 for 
details). Immediately before the label PASSA the subroutine BEGIN is 
called. This is a short subroutine which has already been described in 
chapter 8, figure 7. It simply ensures that the contents of the pointers 
CURAD and BEGAD are the same. As you know, the BEGAD pointer 
indicates the start address of the file. 


PASSA 


Now the processor has reached the label PASSA, thereby initiating the 
first phase of the actual assembly process. To start with, the processor 
jumps to the subroutine OPLEN (see chapter 8, figure 19). This subroutine 
calculates the length of an instruction and stores the result in memory 
location BYTES. This informs the processor how many places the current 
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address pointer (CURAD) should be shifted for the next instruction to be 
examined. 
The Y index register is then loaded with @@ so that it can be used as an 
index to load the accumulator with the opcode of the instruction indi- 
cated by the current address pointer CURAD. The two subsequent instruc- 
tions (CMP #FF and BNE) test to see whether this instruction is actually 
the pseudo-opcode of the label (the label identifier FF). If not, the pro- 
cessor will branch to the section of program headed by the label NXTINS 
(= NeXT tNStruction) as shown in figure 4. 
During the NEXT subroutine (chapter 8, figure 10), the processor directs 
the current address pointer to the following instruction by adding the 
contents of location BYTES to the previous contents of CURAD. This 
subroutine also tests to see whether the current address pointer, which 
should be still pointing to the opcode of an instruction, is still situated 
between the pointers BEGAD and CEND, or whether it has already 
exceeded the CEND pointer. If it is still within the file boundaries, the 
processor will branch back to label PASSA and go on to examine the next 
instruction for the label identifier FF. The length of this instruction will 
again be calculated during the OPLEN subroutine. The above procedure 
is repeated until all the labels have been removed from the file. 
If, however, the processor encounters the label identifier FF, it will not 
branch to label NXTINS, but will deal with the label in question. It is now 
time to find out exactly what this entails. To do this we need to look at 
figures 4 and 5. Figure 4 shows the details of the first assembly phase 
while figure 5 shows part of the symbol stack. Following the (non) branch 
instruction BNE, the process is as follows: 
1. The instruction INY increases the contents of the Y index register 

from @@ to 01. The following instruction (LDA- (CURADL), Y) causes 
the accumulator to be loaded with the contents of the location indicated 
by CURAD + 1. This means that the label number following the identifier 
is now held in the accumulator. 
2. The contents of location LABELS are stored in the Y index register. 

The ensuing instruction (STA- (TABLEL), Y) transfers the number of 
the label being examined to the symbol stack. The actual address in the 
stack in which it is stored will be indicated by the temporary pointer 
TABLE + LABELS, Since the contents of location LABELS were made 
equal to FF at the beginning of the assembler routine, which was when the 
symbol stack pointer TABLE was made equal to the contents of ENDAD- 
FF, the first label number will be stored in the location indicated by the 
end address pointer ENDAD. 
3. DEY 

LDA-CURADH 

STA-(TABLEL), Y) 
The processor has encountered the label identifier FF. The current address 
pointer CURAD will still be directed at the address location where this 
was found. Once the Y index register has been decremented, the high 
order byte of this address will be loaded into the accumulator. The pro- 
cessor now stores this on the symbol stack at the location indicated by 
TABLE + LABELS — 1. The high order byte of the label address will 
now be stored on the symbol stack one location above where the label 
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number was previously stored. 
4. DEY 

LDA-CURADL 

STA-(TABLEL),Y) 
The processor now loads the low order address byte of the location con- 
taining the label into the accumulator in the same manner as before. Next 
it is stored on the symbol stack at the address TABLE + LABELS — 2. The 
low order byte of the label address will therefore be stored one memory 
location above the high order byte of the label address previously stored. 
5. DEY 

STY-LABELS | 
The Y index register has now been decremented three times in succession, 
or rather, the symbol stack pointer has been shifted up by three places. 
The pointer TABLE + LABELS is again pointing to an address in the 
symbol stack where the next label number is to be stored, provided of 
course that there is another label with the pseudo-opcode FF present in 
the file. 
6. JSR-UP 

JSR-RECEND 
All the necessary information regarding the label and its address have now 
been stored on the symbol stack. Thus, the label is no longer required and 
can be deleted from the file. It is the subroutine UP (chapter 8, figure 17) 
which, as you know, performs this task by shifting the remainder of the 
data block up by three memory locations, starting at the opcode of the 
next instruction and ending at CEND. After this shift operation, the file 
will have been shortened by three bytes and so the CEND pointer will 
also have to be shifted up three locations. This is carried out by the sub- 
routine RECEND (chapter 8, figure 14). 
7. JMP-PASSA 

At this stage, the Junior Computer examines the remaining instructions 
iin the file to see whether any of them possess the pseudo-opcode FF. 
Upon encountering further labels in the file, the label number and the 
address where it was found is stored on the symbol stack. Again, the labels 
can be erased from the file. If the instruction turns out to be of a different 
kind, the assembler program (see figure 4) will branch to the section of 
program labelled NXTINS and skip from instruction to instruction until 
it finds a label. 
During the NEXT subroutine, which repositions the current address 
pointer to indicate the following instruction opcode, the processor checks 
whether or not the CURAD pointer has overstepped its mark,by exceeding 
CEND. If the processor has reached the end of the file, the first phase of 
assembly will be complete and the processor will proceed to PASSB after 
the subroutine BEGIN has been executed. This starts the second phase of 
assembly. 
In chapter 5 it was mentioned that at least six memory locations must be 
kept clear between the pointers ENDAD and CEND. If the programmer is 
not sure whether his/her program is the right length, he/she can check to 
see whether there are six free locations between the two pointers (before 
the assembler is started). This can be accomplished by examining the 
contents of the various pointers in page zero: 
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the address of CENDL is @@E8 

the address of CENDH is @@E9 

the address of ENDADL is @0E4 

the address of ENDADH is @@E5 

What about the six memory locations that seem so vital? As you may 
remember, the label number and the absolute address belonging to it are 
stored on the symbol stack, therefore occupying a total of three locations. 
The symbol stack starts at the address indicated by ENDAD. When a label 
is removed from the file, the file becomes three bytes shorter, in other 
words, the CEND pointer moves up three locations. When another label is 
removed from the file there appears to be adequate room for it and its 
address to be stored on the symbol stack in the locations just vacated. 
Therefore, the question is, why insist on six memory locations, when three 
seem to be ample? To find out, let us take another look at the UP sub- 
routine in chapter 8, figure 17. This is where the labels are removed from 
the file. When one is deleted, the data block following it is moved up three 
bytes. This is also illustrated in figure 18 of chapter 8. When the data 
block moves up, the UP subroutine also moves up another three bytes 
behind the pointer CEND. These are superfluous to the assembler, so that 
if only three spaces were left available between the two pointers CEND 
and ENDAD, the last data at the end of the file before the CEND pointer 
would be overwritten by new data. 

Part of the symbol stack after the first phase of program assembly using 
the example from chapter 5 (figures 1... 4) is given in figure 6. All seven 
label numbers and their associated addresses are stored on the symbol! 
stack, It can be clearly seen that the symbol stack is filled with data from 
bottom to top, the fowest tabel being the first to be deleted from the file. 
The first label number is 1@ and it is situated at address 9200. The last 
label to be assembled has the number 16 and can be found at the absolute 
address @24C. This was the last label in the file before the EOF character 
and so it will be stored at the very top of the symboi stack. At this point 
in time the symbol stack pointer TABLE + LABELS will indicate the 
address @2EA. 


PASSB 


This label heads the second phase of assembly. The detailed flowchart of 
this section of the assembier program is given in figure 7. To start with, the 
current address pointer is in the same position as the BEGAD pointer. 
This was the last operation of the first phase of assembly (see figure 4). 
During the second phase the processor checks through all the remaining 
instructions in the file, for initially (during pass one) the computer was 
only interested in labels featuring the pseudo-opcode FF (the label 
identifier). Now that these have all been removed from the file, the pro- 
cessor can concentrate on instructions which need to be assembled. These 
will all have a label number after the opcode. The instructions the pro- 
cessor is now interested in are: 

* JMP instructions 

* JSR instructions and. 

* branch instructions. 
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Figure 6. Part of the symbol stack after the first phase of program assembly using the 
example from chapter 5. The end address pointer ENDAD indicates address location 
O2FF. 


However, these could also be followed by absolute addresses or actual 
displacement values, in which case they must be ignored. Nevertheless, 
conditional and unconditional jump instructions have to be dealt with 
separately during this phase, which we shall describe right away. 
Just as in the program section headed by the label PASSA, the section 
labelled PASSB starts by calling the OPLEN subroutine to ascertain the 
length of the instruction and therefore the number of memory locations 
that the CURAD pointer must be shifted down in the file in order to 
indicate the next instruction. After the Y index register has been loaded 
with 090, the next instruction (LDA- (CURADL), Y) transfers the opcode 
of the instruction under examination to the accumulator. The processor 
then filters out the two jump instructions, JMP and JSR, and then moves 
on to filter out the various branch instructions: 
1. CMP #4C 

BEO 
filters out the JMP instruction which has the opcode 4C. 
2. CMP # 20 

BEQ 
filters out the JSR instruction which has the opcode 20. 
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Figure 7. The detailed flowchart of the second phase of the assembly procedure. 


3. AND #1F 

CMP #10 

BEQ 
filters out all the branch instructions which have the opcodes 19, 30, 59, 
70, 90, B®, D@ and F@. These opcodes correspond to the instructions 
BPL, BMI, BVC, BVS, BCC, BCS, BNE and BEOQ respectively. Because the 
contents of the accumulator (the opcode) are masked by the value 1F, the 
five least significant bits of the data byte will remain unchanged, but the 
three most significant bits will be zero. If the opcodes of the branch 
instructions are considered, it will be apparent that the four least signifi- 
cant bits are always zero. Thus, by masking the five least significant bits of 
the opcode with 1F the result will invariably be 19. By comparing the 
result with the value 1@, the processor can establish whether the opcode 
being examined belongs to a branch instruction or not. 
If neither a jump instruction nor a branch instruction is involved the 
opcode will belong to an instruction that does not require assembling. The 
processor can then deal with the next instruction in the file after it reaches 
the label PB. As we know, the NEXT subroutine points the current address 
pointer CURAD to the address containing the opcode of the following 
instruction. 
If the processor has not yet reached the end of the file, the assembler 
program will branch back to label PASSB to calculate the length of the 
next instruction via the subroutine OPLEN before dealing with it. The 
procedure just described above will then be repeated. 
If, however, a jump or branch instruction is involved, it will have to be 
assembled. For this the Junior Computer will have to place the absolute 
addresses (previously stored on the symbol stack) behind the jump instruc- 
tions. With regard to the branch instructions, on the other hand, the 
displacement values will have to be calculated and then placed behind the 
opcodes. The way in which the computer carries out these tasks with the 
aid of the symbol stack can be seen as follows: 


JMP and JSR instructions 


Ail the unconditional jump instructions are assembled from the label 
JUMPS (figure 7) on. Here the absolute jump address is traced from the 
symbol stack and then placed behind the opcode of the actual jump 
instruction. 
After incrementing the Y index register (the value therein will now be 01) 
the subroutine GETLBL is called. This is shown in detail in figure 8 and 
will be described fully later on. All we have to know about this subroutine 
at this stage can be expressed in a few words: 
1. The subroutine GETLBL searches for the label number behind the 
opcode of the jump instruction being assembled on the symbol stack, 
Once this is found on the symbol stack, the processor has access to the 
absolute address corresponding to it. 
2. The address concerned is fetched from the symbol stack. Before 
returning to the main‘assembler routine, the subroutine GETLBL stores — 
the two bytes of the label address in two internal CPU registers: 
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Figure 8. The detailed flowchart of the GETLBL subroutine. This subroutine obtains 
the label number and associated address from the symbol stack. The high order byte 

of the label address will be held in the X index register and the low order byte in the 
accumulator upon the return from this subroutine. 


the high order byte of the label address will be stored in the X index 
register 

the low order byte of the label address will be stored in the accumu- 
lator. 

3. If the processor can find the required label number on the symbol stack 
it will return from the GETLBL subroutine with the Z flag reset. 
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A. |If the computer can not find the label in question it will return to the 
main assembler routine with the Z flag set. 
Let us assume that the processor has found the label number on the 
symbol stack during the GETLBL subroutine. It will then return to the 
main assembler routine with the high order byte of the label! address in the 
X index register and the low order byte of the label address in the accumu- 
lator. The Z flag will have been reset, therefore there will be no branch to 
the label PB at the next BEOQ instruction. The Y index register will still 
contain the value @1. The following instruction (STA- (CURADL), Y) 
ensures that the low order byte of the label address is stored immediately 
behind the opcode of the instruction being assembled. Then the high 
order byte of the label address is transferred from the X index register into 
the accumulator and the Y index register is incremented once more. The 
next instruction (STA- (CURADL), Y) places the high order byte of the 
label address immediately behind the low order byte in the file. 
Before assembly, the jump instruction was stored in the file like this: 
Opcode, xx, #0. Where the opcode is either 20 or 4C, xx is a random label 
number and the value @@ represents the limiter byte. After assembly the 
jump instruction is stored in the file with the two correct operand 
bytes: — 4 
Opcode, ADL, ADH. The opcode will be the same, but the operand bytes 
ADL (= low order byte of the label address = low order byte of the absol- 
ute jump address) and ADH (= high order byte of the label address = high 
order byte of the absolute jump address) have replaced the label! number 
and the limiter byte. The entire jump instruction has now been assembled. 
The correct absolute address for the jump instruction has been fetched 
from the symbol! stack and stored behind the opcode of the jump 
instruction. | 


Branch instructions 


If, during the second phase of assembly, the processor comes across a 
branch instruction in the file, it will have to calculate the required displace- 
ment value corresponding to that instruction. This will mean removing the 
label number from behind the opcode of the branch instruction. This type 
of instruction is assembled from the label BRINST onwards. Firstly the Y 
index register is incremented (the value in the Y index register will now be 
1) and the processor jumps to the GETLBL subroutine. This is where the 
processor obtains the absolute address belonging to the label number and 
to which the branch must take place from the symbol stack. If the com- 
puter can locate the required label number on the symbol stack it will 
return from the subroutine GETLBL to the assembler main routine with 
the Z flag reset. As before, the high and low order label address bytes will 
be held in the X index register and the accumulator respectively. Now how 
can the processor calculate the actual displacement value of the branch 
instruction and store it behind the opcode? To answer this question we 
must assess exactly what the computer ‘knows’ about the branch instruc- 
tion being assembled at this moment in time. 
1. Upon its return from the GETLBL subroutine, the computer knows 
the label address to which the proposed branch is to take place. The 
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low order byte of the label address is stored in the X index register and the 
high order byte in the accumulator. These two address bytes constitute the 
destination address, in other words, the location to which the processor 
must branch. 
2. The current address pointer CURAD informs the computer of the 
address where the opcode of the branch instruction being assembled 
is actually situated. This will be the source address, in other words, the 
location from which the processor is to effect the branch. This will consist 
of the contents of the current address pointer, stored in memory locations 
OOEG6 and OG0E7. 
3. From the source and destination addresses the computer is able to 
calculate the actual displacement value: 
Displacement = destination address — source address — 92. 
The reason for subtracting the extra two units is because after a branch 
instruction has been decoded the program counter of the CPU will 
be pointing to the opcode of the next instruction. Once the displacement 
value has been calculated, this will have to be inserted behind the branch 
instruction being assembled. The penultimate instruction of the section 
of program labelled BRINST (STA-(CURADL), Y) replaces the label 
number behind the branch instruction with the displacement value. At the 
same time this will complete assembly of the branch instruction. 
Now that we have become familiar with the main assembler routine, let 
us examine the main points of the two phases involved once more: 


Phase one: | 

The absolute addresses of the labels together with the actual label numbers 
are stored on the symbol stack. Then the processor deletes the label from 
the file and shifts the data block following it up by three memory 
locations. Thus the label is overwritten. During the shift operation the 
next label in the file moves up three positions. In the first phase of as- 
sembly, therefore, the opcodes of the labels not yet removed from the file 
keep their locations. The symbol stack contains all the information re- 
quired concerning the labels erased from the file. Label numbers and 
addresses remain unchanged during the entire assembly procedure. 


Phase two: 

Once all the labels have been removed from the file, all the required 
information concerning them will have been stored on the symbol stack 
and the second phase of the assembly procedure can begin. This is where 
the computer checks through the file for all the instruction opcodes 
followed by a label number. The opcodes for the JMP, JSR and branch 
instructions are filtered out of the file. In the case of jump instructions, 
the processor searches the symbol stack for the label number situated 
behind the instruction opcode being assembled. This gives the processor 
access to the address of the label, which is the absolute jump address and 
which is inserted directly behind the opcode of the jump instruction in 
the file. 

Where branch instructions are concerned, the displacement value still has 
to be calculated. it is found by subtracting the source address from the 
destination address and the result is stored in the file directly behind the 
opcode of the branch instruction. 
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The subroutine GETLBL 

The central subroutine of the assembler program is the GETLBL sub- 

routine. During this subroutine the processor obtains the address of the 

particular label from the symbol stack — provided of course there is a 

JMP, JSR or branch instruction to be assembled in the file. The function 

of this subroutine can be described as follows: 

1. Search for the label number on the symbol stack. 

2. Once this has been found, fetch the fabel address from the symbol 
stack. Place the high order byte of the label address in the X index 
register and the low order byte of the label address in the accumulator. 

3. If the label number is not present in the symbol stack, return to the 
main assembler routine with the Z flag in the status register set. 

As can be seen from the detailed flowchart of the GETLBL subroutine 
in figure 8, the first instruction loads the label number into the accumu- 
lator (at this time the contents of the Y index register are 01). The con- 
tents of the Y index register are then made equa! to FF. Before we con- 
tinue with the description of the GETLBL subroutine, the following 
points should be kept in mind: 

“ The address indicated by the symbol stack pointer TABLE + LABELS 
is the highest vacant location in the symbol stack. During the second 

phase of assembly, the symbol stack increases from address TABLE + FF 

(= ENDAD) to address TABLE + LABELS. 

“ TABLE + FF contitutes the ‘bottom’ of the symbol stack, whereas the 
top of the stack is formed by TABLE + LABELS. All the relevant 

table information is stored between these two (‘piled on’ during PASSA). 

“ The search for a labe! number on the symbol stack starts at the bottom, 
at address TABLE +FF, and ends at the top, at address TABLE + 
LABELS. 

Back to the program. After the label SYMA the processor checks whether 

or not the symbol stack pointer has already reached the top of the symbol 

stack, The instruction used to find this out is CPY-LABELS. The sub- 
sequent comparison (CMP- (TABLEL), Y) compares a label number on 
the symbol stack to one in the file. What exactly is the procedure for this? 

Before this comparison takes place the situation is as follows: 

1. During PASSB the processor has encountered the opcode of an instruc- 
tion which is followed by a label number. This instructions needs to be 
assembled, therefore the GETLBL subroutine is called. 

2. The label number situated behind the opcode of the instruction must 
then be loaded into the accumulator. 

3. At the moment the symbol stack pointer is pointing to the address 
location TABLE + FF. This is where the first label number was stored 

on the symbol stack. The processor now compares the label number in the 

accumulator to the one on the symbol stack by means of the instruction 

CMP- (TABLEL), Y). If the label numbers are different, the processor 

will branch back to the label SYMNXT, where the Y index register iS; 

decremented three times in succession. 

4. Since the contents of the Y index register will not be zero at this point, 
the processor will branch to the label SYMA. Following this the pro- 

cessor compares the label number in the accumulator with the next label 

number on the symbol stack. ° 
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5. If the two label numbers are still different, the Y index register is again 
decremented three times so that the symbol stack pointer indicates the 

position where the next label is stored. If, however, the two label numbers 

are the same, the label number concerned will have been found. 

6. The label number has now been found on the symbol stack. The 
address belonging to it can now be obtained from the symbol stack. 

First, the high order byte of the label address is retrieved from the symbol 

stack, The instructions for this purpose are: 

DEY 

LDA- (TABLEL), Y 

TAX . 

As the Y index register is decremented by one, the symbol stack pointer 

will indicate the location where the high order byte of the label address 

is stored. This is then loaded in the accumulator and from there trans- 

ferred to the X index register. Following this the contents of the Y index 

register are decremented once more, which causes the symbol stack 

pointer to indicate the location where the low order byte of the label 

address is stored. This is then loaded into the accumulator. The two 

instructions which perform this operation are: 

DEY 

LDA- (TABLEL), Y | 

At this stage in the proceedings the high order byte of the label address 

will be held in the X index register and the low order byte of the label 

address will be held in the accumulator. 

7. The subroutine GETLBL has yet another purpose: 

“If the label number on the symbol stack was found to be the same as 

that of the instruction being assembled, the Z flag in the status register 

will have to be reset. | 

If the required label number was not found on the symbol stack, the 

Z flag in the status register will have to be set. 

To reset the Z flag the processor uses the instruction LDY # 01 directly 

before the label SYMB. This instruction can only be carried out if the 

computer has found the required label number on the symbol stack. 

If, however, the processor has searched through the entire symbol stack in 

vain, the Z flag will have to be set. If the label number does not happen to 

be present on the symbol stack, the search will be discontinued when the 

symbol stack pointer has reached the top of the symbol stack. This is the 

only time that the pointer TABLE + Y will indicate the same address as 

TABLE + LABELS. By comparing the pointer LABELS and the contents 

of the Y index register, the processor is able to determine whether or not 

the required label number is present on the symbol stack. This comparison 

takes place after the label SYMA: 

CPY-LABELS. | 

If indeed the label number turns out to be non-existent the result of this 

comparison will be zero. This in turn means that the Z flag will be set as 

mentioned and the processor will return to the main assembler routine 

immediately by way of the label SYMB. 

Now that we have discussed the assembler routine, we can appreciate why 

it is so closely related to the editor routine. They both utilise the same 

subroutines. This is a great advantage for the programmer, for once he/she 
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has mastered their operation, they can be incorporated into his/her own 
programs. The source listing of all the subroutines described is given in 
the back of this book. This is very practical, regardless of whether the sub- 
routines are used by the main monitor, editor or assembler routines. It is 
very useful for the novice programmer to understand how the same sub- 
routine(s) can be used for different tasks. In addition, the source listings 
for the sample programs given in chapters 5 and 6 are also provided at 
the back of the book. 


The BRANCH routine 


On several occasions in Book! it was mentioned that the EPROM con- 
tained a program which allows the calculation of displacement values 
pertaining to branch instructions. This program is called BRANCH and 
starts at address location 1FD5. The program is in fact an infinite loop 
(see figure 9) which can only be left by depressing either of the keys RST 
or ST, or by way of an external interrupt (NMI or IRQ). 

Once the BRANCH routine has been started, the display will show 
00 00 90. The programmer is now able to enter the low order byte of the 
address containing the opcode of the branch instruction. This is then 
shown on the two left hand digits of the display. 

Following this the programmer is able to enter the low order byte of the 
address where the processor is to branch to. This will then be shown on 
the two centre digits of the display. Finally, the two right hand digits will 
show the actual displacement value. 

When data is entered, only the low order bytes of the source and desti- 
nation addresses have to be keyed in, as the 6502 processor can only 
branch 127 bytes forwards and 128 bytes backwards. 

Once a displacement value has been calculated, the display will again show 
90 00 OO if any of the command keys are depressed. The same will occur 
during the entry of the next two address bytes. 

With regard to the BRANCH routine we can be fairly brief, since the 
displacement values are of course calculated along the same lines as 
described in figure 7: 

To start with, the computer is placed in the binary arithmetic mode and 
the display buffers POINTH, POINTL and INH are loaded with the value 
00. The subroutine GETBYT is then called after the label BR. As we 
know, this subroutine combines the values of two hexadecimal keys into 
one byte and holds the result in the accumulator and returns to the 
BRANCH routine with the N flag set. 

If during the GETBYT routine a command key is depressed, the N flag 
will be reset and the processor will branch back to the label BRANCH 
upon the return from subroutine GETBYT. This also causes the display 
to be reset. 

Once the two key values have been stored in the accumulator, the latter’s 
contents are transferred to the display buffer POINTH. This means that 
POINTH now contains the low order byte of the address at which the 
opcode of the branch instruction is located. The subroutine GETBYT is 
then called a second time to obtain the low order byte of the destination 
address. This is then transferred to the display buffer POINTL in the 
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Figure 9. The detailed flowchart of the BRANCH subroutine. This routine enables 
the programmer to calculate the displacement values of branch instructions. 


same manner as before. The Junior Computer can then go ahead and 
calculate the displacement value. 

At this time the accumulator still holds the low order byte of the desti- 
nation address. After clearing the carry flag the processor subtracts the low 
order byte of the source address (POINTH) from the contents of the 
accumulator. Since the carry flag was reset before the subtraction took 
place (which incidentally is strictly not allowed!!!) the result will be 
one location short. Although the wrong result is therefore stored in the 
display buffer INH, the processor decrements the contents of INH so 
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fast that it is never noticed. The value contained in the display buffer 
INH will now be correct. The program then branches back to label BR 
and there the subroutine GETBYT shows the low order bytes of the 
source and destination addresses and the calculated displacement value 
on the display. 7 

This brings us to the end of Book JI. In both Books | and II we have tried 
to show the reader how to develop useful programs as simply as possible 
on a small computer. This in fact covers the description of the standard 
version of the Junior Computer. This does not mean, however, that it 
is the end of the Junior Computer. This book terminates with an appendix 
containing a summary of the subroutines described and a source fisting of 
the entire monitor program with extensive commentary, a real treasure 
for software enthusiasts. Those of you who have successfully come to 
terms with Book | and Il may look forward to reading Book III, for here 
the Junior Computer develops into a powerful personal computer by 
means of an elaborate, yet inexpensive hardware expansion system. 

Happy programming! 


192 


Appendix 1 


The program listing of the EPROM 


The monitor, the editor and the assembler 


The next ten pages contain a survey of the EPROM contents. It is the ‘expanded’ 
version of Appendix 3 in Book 1, which showed the contents in the form of a hex 
dump (in bytes only). 

The listing includes the following: 


1. 


P WH 


2 


11. 


SOON 


A survey of all the RAM memory locations in page 96 {temporaries) and in page 
1A (PIA addressing and locations for the NMI and IRQ jump vector). 
The main monitor routine (1C@@... 1CB4). 
The main editor routine (1CB5... 1D4C). 
Subroutines as part of: 
a. the editor: SCAN (1D5C... 1DG6E): 
b. the editor and the BRANCH routine: GETBYT (1D6F .. . 1D87): 
c. the editor and the monitor: SCAND(S) (1D88 ... 1E1F, including SHOW, 
CONVD and GETKEY): 
. the editor: RDINST (1E2@0...1E46) and FILLWS (1&47... 1£5B): 
the editor and the assembler: OPLEN/LENACC (1E5C...1£82); 
the editor and the assembler: UP (1E83... TEA5): 
the editor: ADCEND (1EDC ... 1ED2): 
the editor and the assembler: BEGIN; 
i. the editor: ADCEND (1EDC...1E€9); 
j. the editor and the assembler: RECEND (1EEA...1EF7) and 
NEXT (1EF8...1FQE). 
Look-up table LOOK, used by the monitor and the editor (subroutine CONVD) 
(1FOF...1F1E). 
Look-up table LEN, used by the editor and the assembler (subroutine OPLEN/ 
LENACC (1F1F...1F2E). 
Subroutine GETLBL, used in the assembler (1F35...1F5@). 
The main assembler routine (1F51...1FD2). 
The displacement calculation routine BRANCH (1FD5...1FF7). 
Six EPROM locations to establish the NMI, RES and IRQ vectors 
(1FFA...1FFE) and six locations for the two JMP-IND instructions involved 
(see chapter 3 in Book 1) (1F2F...1F34). 
N.B. Locations 1FF8 and 1FF9 are not used. When the EPROM is programmed 
they are filled with FF. 
All the labels and names of memory locations that are used in the monitor, 
the editor and the assembler, in alphabetical order, plus the corresponding 
address. 


Fea wea 
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eee: 
6818: 
0028: 
@038: 
2048: 
0858: 
8060; 
e070: 
2080: 
0690: 
91890: 


a@1190: 
0120: 
813e@: 
014@: 


8158 


01690: 
8178: 
180: 
8198: 
@200: 
0218: 
@228: 
0238: 
0248: 
8258: 
8268: 
6270: 
0280: 
8290: 
0300: 
0318: 
0320: 
0330: 
@3490; 
0350; 
9360: 
0370: 
@388: 
8398: 
0488: 
0416: 
8428: 
0438: 
0448. 


8458 


0468: 
0478: 
0480: 


8490: 


8580; 


6518: 
6528; 
6538; 
6548: 


8558: 


0568: 
6570. 
658@: 
0590: 
8688: 
0619: 
06248: 
8638: 
8648: 
8658; 
8668: 
G67B: 
06886: 
6698: 
8700: 
08718: 
0728; 
9730: 
0740: 
0758: 
0760: 
778: 
2788; 
0790. 
8800. 
06148. 
@82@. 
0830; 
6846, 
8858. 
8868: 
8876, 
@88Q. 
8890. 
6986: 
@918: 
@928: 
O938: 
8948: 
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1C98 


1C88 
1C 6B 
1C 88 
1C 0d 
1C 8B 
1008 
1000 
1C@8 
1C 8B 
1CB¢@ 
1C8@ 
1C 88 
1008 
1C 88 
1C 88 
1C8@ 


1C 88 
1C@@ 
1C6@ 
1C 8a 
1C@¢@ 
1c @@ 
1C@a 


1088 
1C 8B 
1CQB 
1C 88 


1C@B 
1C@6 
1caeB 
1C@8 


1C 88 
1C88 
1C QB 
1¢986 


1c8@ 
1088 
1c@ea 
1c ae 


1c Bd 


1C 68 
1c 86 
1c82a 
1C66 


1C68 
1088 
1c 88 
1caa 


LOYS ORG $1C AB 


SOURCE LISTING OF E 


VERSION D 


LEKTOR'S JUNIOR COMPUTER 


WRITTEN BY A. NACHTMANN 


DATE: 7 FEB. 1988@ 
THE FEATURES OF JUN 


HEX ADDRESS DATA DI 


IOR'S MONITOR ARE: 


SPLAY (ENTRY VIA RST) 


HEX EDITOR {START ADDRESS $1CB5} 
HEX ASSEMBLER (START ADDRESS $1F51) 


EDITOR'S POINTERS AND TEMPS IN PAGE ZERO 


KEY . S@8E1 
BEGADL * S@BE2 
BEGADH * SOBE3 
ENDADL * SOBE4 
ENDADH * S$O@BE5 
CURADL * SBBE6 
CURAPH * S@BE7 
CENDL * S8QE8 
CENDH * S$OBE9 
MOVADL * SB@EA 
MOVADH * SOBEB 
TABLEL * S@BEC 
TABLEH * SORBED 
LABELS * SOBEE 
BYTES * S$BOFE 
COUNT * SBOF? 


BEGIN ADDRESS POINTER 
END ADDRESS POINTER 
CURRENT ADDRESS POINTER 


CURRENT ADDRESS POINTER 


NUMBER OF BYTES TO BE DISPLAYED 


MPU REGISTERS IN PAGE ZERO. 


PCL * SOGEF 
PCH * S@OFB 
PREG . $@0F1 
SPUSER * $BOF2 
ACC * SOF 3 
YREG * S@QF4 
XREG * SO@F5 


HEX DISPLAY BUFFERS 


INL * SOOF8 
INH = SOOF9 
POINTL * SOOFA 
POINTH * S@BFB 


TEMPORARY DATA BUFF 


TEMP * SOBFC 
TEMPX * $OBFD 
NIBBLE * SOBFE 
MODE 7 SOOFF 


MEMORY LOCATIONS IN 


PAD 7 S1A8B 
PADD * $1A8]1 
PBD * $1A82 
PBDD x $1A83 


WRITE EDGE DETECT € 


EDETA * SIAE4 
EDETB * S1AES5 
WDETC * S1LAE6 
EDETD * S1AE? 


READ FLAG REGISTER 
RDFLAG * $1aAn5 


WRITE COUNT INTO TI 


CNTA of S1AF4 
CNTB . SLAFS 
CNTC * SIAFE6 
CNTD 7 SLAF? 


WRITE COUNT INTO TI 


CNTE * S1AFC 
CNTF * SIAFD 
CNTG * SIAFPE 
CNTH * S1AFF 


INTERRUPT VECTORS: 


= FLAGS 


IN PAGE ZERO 


ERS IN PAGE ZERO 


{@ = DA MODE, #@ = AD MODE) 
THE 6532-IC 


DATA REGISTER OF PORT A 
DATA DIRECTION REGISTER OF PORT A 
DATA REGISTER OF PORT B 
DATA DIRECTION REGISTER OF PORT B 


ONTROL 

NEG EDET DISABLE PA?7-IRQ 
POS EDET DISABLE PA?7-IRQ 
NEG EDET ENABLE PA?-IRQ 
POS EDET ENABLE PA?7-IRQ 
AND CLEAR TIMER & IRQ FLAG 
BIT6=PA7-FLAG; BIT?=TIMER-FLAG 
MER, DISABLE TIMER-IRQ 
CLKIT 

CLK8T 

CLK64T 

CLKIKT 
MER, ENABLE TIMER-IRQ 


cLK1T 
CLK8T 
CLK64T 
CLKIKT 


IRQ & NMI VECTORS SHOULD BE 


LOADED IN THE FOLLOWING MEMORY LOCATIONS FOR 
PROPER SYSTEM OPERATION. 


0958: 
0968: 
6978: 
8968: 
8999: 
1860@: 
18618: 
1428: 
1036: 
1048: 
1658: 
1968: 
1878: 
1698: 
196: 
1188 
1lis 
1126 
1136: 
114@: 
115@: 
1166: 
1178: 
1186: 
1198: 
1288: 
3218: 
122@: 
12308: 
1246 
1256: 
1268; 
1278; 
1288; 
1298: 
1308: 
1318: 
1328: 
1338: 
134¢@: 
1356: 
1366: 
1376: 
1386: 
1398: 
1488: 
1410: 
1426: 
1438: 
1448: 
14590: 
1468: 
1470: 
1486: 
1498: 
1588: 
1518: 
1528: 
1538: 
1548: 
155@: 
1568: 
1578: 
1588; 
1598: 
1608: 
1618: 
1628: 
i638: 
1648: 
1658: 
16686: 
i678: 
1688: 
1696: 
1768; 
17186: 
1728: 
1738: 
1748: 
1758: 
1768: 
1778: 
1788: 
1798: 
160@: 
1818: 
1828: 
1839: 
1846: 
18568: 
1868; 
1878; 
1888; 
1898; 


1C88 
1¢88 
1cag@ 
1c88 


1C88 
1c@2 
1083 
1085 
1086 
1C88 
1C@A 
1C@B 
iC@D 
1C@F 
1cil 
1€13 
1c14 
1016 
1ci8 
1clA 


1cip 
1cler 
1€22 
1¢24 
1€ 26 
1€28 
1C 2A 
1c 2c 
1C2E 
1c 2F 
1¢c31 
1032 


1C33 
1C 36 
1038 
1¢3B 
1¢3D 
1ic4@ 
1042 


1¢45 
1¢47 
1c 49 
1C 4B 
ic4c 
IC4E 
1c 4F 
Ic5l 
1¢52 
1¢54 
1¢55 
1¢57 
ic53 
ic5B 
1Cde 
iCSE 
1c 68 
1C62 
1C64 


1C66 
1C68 
1C6A 
1céc 
1C6E 


1c78@ 
1c72 
1074 
1076 
1c78 
1C7A 


1C7D 
1C7F 
1cél 
1¢83 
1c85 
1¢ 87 
1c 89 


1c 8c 
1C8E 


88 
FB 
88 
FB 
88 
F6 
F9 


13 
13 
F2 


FB 
FA 
Fi 
FS 
F3 


18 
86 
83 
FF 
14 


ll 
a6 
ae 
FF 
BA 


12 
89 
FA 
G2 
FB 
33 


14 
48 


FA 
F@ 


7A 


15 
EA 


1c 


1A 


1D 
1D 


1D 


1c 


Ic 


NMIL * S1ATA 
‘NMI * S$1A7B 
IRQL * SIA7E 
IRQH 7 S1ATF 


BEGINNERS MAY LOAD 


NMI LOWER BYTE 
NMI HIGHER BYTE 
IRQ LOWER BYTE 
IRQ HIGHER BYTE 


INTO THESE LOCATIONS 


$1C@@ FOR STEP BY STEP MODUS AND BRK COMMAND 


JUNIOR'S MAINROUTIN 


SAVE STAZ ACC 


PLA 

STAZ PREG 
SAVEA PLA 

STAZ PCL 

STAZ POINTL 

PLA 

STAZ PCH 


STAZ POINTH 
SAVEB STYZ YREG 


STX2 XREG 
TSX 

STX SPUSER 
LDXIM $8] 
STXZ MODE 


JMP START 


RESET LDAIM $1E 


STA PBDD 
LDAIM $84 
STAZ PREG 
LDAIM $83 
STAZ MODE 
STAZ BYTES 
LDXIM SFF 
TXS 

STXZ SPUSER 
CLD 

SET 


START JSR SCAND 
BNE START 
STARA JSR SCAND 
BEQ STARA 
JSR SCAND 
BEQ STARA 
JSR GETKEY 


GOEXEC CMPIM $13 
BNE ADMODE 
LDXZ SPUSER 


TXS 

LDAZ POINTH 
PHA 

LDAZ POINTL 
PHA 

LDAZ PREG 
PHA 

LDXZ XREG 
LDYZ YREG 
LDAZ ACC 
RTI 


ADMODE CMPIM $18 
BNE DAMODE 
LDAIM $83 
STAZ MODE 
BNE STEPA 


DAMODE CMPIM $11 


BNE STEP 
LDAIM $88 
STAZ MODE 


BEQ STEPA 


STEP CMPIM $12 
BNE PCKEY 
INCZ POINTL 
BNE STEPA 
INCZ POINTH 

STEPA JMP START 


PCKEY CMPIM $14 
BNE ILLKEY 


LDAZ PCL 
STAZ POINTL 
LDAZ PCH 


STAZ POINTH 
JMP STEPA 


ILLKEY CMPIM $15 
BPL STEPA 


ES 


SAVE ACCU 

GET CURRENT P-REGISTER 
SAVE P~REGISTER 
GET CURRENT PCL 
SAVE CURRENT PCL 

PCL TO DISPLAY 8UFFER 
GET CURRENT PCH 

SAVE CURRENT PCH 

PCH TO DISPLAY BUFFER 
SAVE CURRENT Y-REGISTER 
SAVE CURRENT X-REGISTER 
GET CURRENT SP 

SAVE CURRENT SP 

SET AD-MODE 


PB1---PB4 
IS OUTPUT 
RESET P-REGISTER 


SET AD~MODE 
DISPLAY POINTH, POINTL, INH 
ADJUST THE STACKPOINTER 


DISPLAY DATA SPECIFIED BY POINTH, POINTL 
WAIT UNTIL KEY IS RELEASED 

DISPLAY DATA SPECIFIED BY POINT 

ANY KEY DEPRESSED 

DEBOUNCE KEY 
ANY KEY STILL DEPRESSED 

IF YES , DECODE KEY,RETURN WITH KEY IN ACCU 
GO~KEY? 

GET CURRENT SP 


START EXECUTION AT POINTH, POINTL 


RESTORE CURRENT P REGISTER 


EXECUTE PROGRAM 
AD-KEY? 


SET AD-MODE 


loess 
DA-KEY? 
SET DA-MODE 
alweis 


PLUS~KEY? 


PC-KEY? 


LAST PC TO DISPLAY BUFFER 


ILLEGAL KEY? 
IF YES,IGNORE IT 
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19086; 
1918: 
1928: 
1938: 


1946: 
1956: 
1968: 
1978: 


1988: 
1998: 
2068: 
2016: 


2028: 


2038: 
2048: 
2058: 
2866: 


2070: 


2088: 
2098: 
2188: 
2118: 
2128; 
2136: 
2148: 
2158: 
21686: 


2176: 


2186; 
2198. 
2286: 
2218: 
2326: 
2238: 
2248: 
2258: 
22008: 
2276: 
2288: 
2298: 
2300: 
2318: 
2328: 
2338: 
2348: 
2358: 
2368: 
2376: 
2388: 
2398: 
2488: 
2418: 
2428: 
2438: 
2448: 
2458: 
2468: 
2478: 
2488: 
2498, 
2508, 
2516: 
2528: 
2538: 
2546: 
25590: 
2560: 
2570: 
2588: 
2590: 
2600: 
2619: 
2628: 
2630: 
2648: 
2658: 
2668: 
2678: 
2688: 
2698: 
2788: 
2718: 
2728 
2738 
2746* 
2758 
2768: 
2770: 
2786: 
2796: 
2888: 
2816: 
2828: 
2838: 
2848: 


" 


as 


o 
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1038 
1C92 
1094 
1096 
1c 98 
1c99 
1C9A 
1C 9B 
1¢9¢ 
1C9E 
ICAB 


1CA3 
1CA5 
ICA? 
1CA9 
1CAA 
1cAC 
1CAE 
1CB8 
1CB2 


icB5 
1CB8 
ICBA 
ICBC 
ICBD 
ICBF 
1cCcB@ 
1cc2 
1cc4 
1cC6 
1cc8 


1CCA 


1¢cD 
1CCF 
icDl 
1cb4 
1CD6 
1cD8 
1CDB 
icDD 
1CDF 
1CE2 
1CE4 
iCE6 
1CE8 
iCEA 
1CEB 
ICED 
1CEF 
1CFi 
1CF4 
1CE? 
1CF9 


1CFB 
1CFD 
ICFF 
1D82 
1D@4 
1D87 


iDeY 
1D8B 
iD#D 
1D1i8 
1D12 
1B15 
1018 
IDIA 


28 
A4 
A6 


De 
C8 
86 
84 
A3 
AB 
91 


28 


El 
FF 


FA 


D3 
E2 
81 
E8 
E9 
77 
8@ 
E6 


4D 


Ic 


1E 


1D 


1D 


1D 


1E 


IE 
1E 


1E 


1E 


1E 


1E 
LE 


DATA STAZ KEY SAVE KEY 
LDYZ MODE Y=@ IS DATA MODE,ELSE ADDRESS MODE 


BNE ADDRES 
LDAIY POINTL GET DATA SPECIFIED 


ASLA BY POINT 

ASLA SHIFT LOW ORDER 

ASLA NIBBLE INTO HIGH ORDER NIBBLE 
ASLA 

ORAZ KEY DATA WITH KEY 


STAIY POINTL RESTORE DATA 
JMP STEPA 


ADDRES LDXIM $B4 4 SHIFTS 
ADLOOP ASLZ POINTL POINTH,POINTL 4 POSITIONS TO LEFT 
ROLZ POINTH 
DEX 
BNE ADLOOP 
LDAZ POINTL 
ORAZ KEY RESTORE ADDRESS 
STAZ POINTL 
JMP STEPA 


JUNIOR'S HEX EDITOR 
FOLLOWING COMMANDS ARE VALID: 
"INSERT": INSERT A NEW LINE JUST BEFORE DISPLAYED LINE 


"INPUT": INSERT A NEW LINE JUST BEHIND THE 
DISPLAYED LINE 


"SEARCH"; SEARCH IN WORKSPACE FOR A GIVEN 28YTE PATTERN 
"SKIP": SKIP TO NEXT INSTRUCTION 
"DELETE": DELETE CURRENT DISPLAYED INSTRUCTION 


AN ERROR IS INDICATED, IF THE INSTRUCTION POINTER 
CURAD JS OUT OF RANGE 


EDITOR JSR BEGIN CURAD: =BEGAD 
LDYZ2 BEGADH 
LDXZ BEGADL 
INX 
BNE EDIT 
INY 

EDIT STXZ CENDL CEND: =BEGAD+] 
STYZ CENDH 
LDAIM $77 DISPLAY "7?" 
LDYIM $88 
STALY CURADL 


CMND JSR SCAN DISPLAY CURRENT INSTRUCTION,WAIT FOR A KEY 


SEARCH CMPIM $14 SEARCH COMMAND? 
BNE INSERT 
JSR GETBYT READ 1ST BYTE 
BPL SEARCH COM. KEY? 
STAZ POINTH DISCARD DATA 
JSR GETBYT READ 2ND BYTE 
BPL SEARCH COM. KEY? 
STAZ POINTL DISCARD DATA 
JSR BEGIN CURAD: =BEGAD 


SELOOP LDYIM $8@@ 
LDAIY CURADL COMPARE INSTRUCTION 


CMPZ FOINTH AGAINST DATA TO BE SEARCHED 
BNE SEARA SKIP TO NEXT INSTRUCTION, IF NOT EQUAL 
INY 
LDALTY CURADL 
CMPZ POINTL 
BEQ CMND RETURN, IF 2BYTE PATTERN IS FOUND 

SEARA JSR OPLEN GET LENGTH OF THE CURRENT INSTRUCTION 
JSR NEXT SKIP TO NEXT INSTRUCTION 
BMI SELOOP SEARCH AGAIN, IF CURAD IS LESS THAN CEND 
BPL ERRA 


INSERT CMPIM $18 INSERT COMMAND? 
BNE INPUT 
JSR RDINST READ INSTRUCTION AND COMPUTE LENGTH 
BPL SEARCH COM. KEY? 
JSR FILLWS MOVE DATA IN WS DOWNWARD BY THE AM. IN BYTES 
BEQ CMND RETURN TO DISPLAY THE INSERTED INSTR. 


INPUT CMPIM $13 INPUT COMMAND? 
BNE SKIP 
JSR RDINST READ INSTRUCTION AND COMPUTE LENGTH 
BPL SEARCH COM. KEY? 
JSR OPLEN LENGTH OF THE CURRENT INSTR. 
JSR NEXT RETURN WITH N=l1, IF CURAD IS LESS THAN CEND 
LDAZ TEMPX LENGTH OF INSTR. TO BE INSERTED 
STAZ BYTES 


2858: 1D1C 28 47 1E JSR FILLWS MOVE DATA IN WS DOWNWARD BY THE AM. IN BYTES 


286@: I1DIF FR AQ BEQ CMND RETURN TO DISPLAY THE INSERTED DATA 

2B7@8: 

2888: 1D21 c9 12 SKIP CMPIM $12 SKIP COMMAND? 

2898: 1D23 De B7? BNE DELETE 

298@: 1025 26 FS IE JSR NEXT SKIP TO NEXT INSTRUCTION. CURAD LESS THAN CEND? 
2918: 1028 36 A@ BMI CMND 

292@: 1D2A 18 @D BPL ERRA 

2930: 

2948: 1D2c c9 ll DELETE CMPIM $l1l DELETE COMMAND? 

2950; ID2E DB a9 BNE ERRA 

2968: 1D3@ 28 83 1EF JSR UP DELETE CURRENT INSTR. BY MOVING UP THE WS 
2978: 1033 280 EA IE JSR RECEND ADJUST CURRENT END ADDRESS 

2988: 1D36 4c CA 1C JMP CMND 

2998: 

30@@: 1039 AS FE ERRA LDAIM SEE 

3418: 1D3B 85 FB STAZ POINTH 

3026: 1D3D 85 FA STAZ POINTL 

3038: I1D3F 85 Fg STAZ INH 

3848: 1D41 AS @3 LDAIM $@3 

3058: 1043 85 F6 STA? BYTES 


3@6@: 1D45 2@ 8E 1D ERRB JSR SCANDS DISPLAY EEEEEE UNTIL KEY IS RELEASED 
3076: 1048 Dg FB BNE ERRB 


3080: 1D4A 4C CA lc UMP CMND 

3896: 

3108: 

3118: 

3120; 

3138: EDITOR'S SUBROUTINES 

3140: 

3154: SCAN IS A SUBROUTINE, FILLING UP 

316@; THE DISPLAY BUFFER DETERMINED BY 

3176: CURAD. THEN THE DISPLAY IS SCANNED 

3186: DEPENDING OF THE LENGTH OF THE INSTRUCTION 
3198: POINTED BY CURAD 

3208: IF A DEPRESSED KEY IS DETECTED 

3218; 

3228: 

323: 

324@: 

3256; SCAN RETURNS WITH VALUE IN ACCU 

3268. 

3278: 1D4D A2 @2 SCAN LDXIM $@2 FILL UP THE DISPLAY BUFFER 
3286: 1D4F A@ 6p LDYIM S@B 

3298: 1D51 Bl E6 FILBUF LDAIY CURADL START FILLING AT OP CODE 
3368: 1D53 95 F9 STAX INH 

3310: 1D55 cB INY 

3320: 1D56 CA DEX 

333%: 1D57 18 FB BPL FILBUF 

3346: 1D59 26 SC 1E JSR OPLEN STORE INSTRUCTION LENGTH IN BYTES 
3358: 1D5C 28 8F 1D SCANA JSR SCANDS DISPLAY CURRENT INSTRUCTION 
3360: 1ID5SF D® FB BNE SCANA KEY RELEASED? 

3376: 1D61 2@ 8E 1D SCANB JSR SCANDS DISPLAY CURRENT INSTRUCTION 
3386: 1D64 FO FB BEQ SCANB ANY KEY DEPRESSED? 

3398: 1D66 286 BE lp JSR SCANDS DISPLAY CURRENT INSTRUCTION 
3408: 1D69 FO F6 BEQ SCANB ANY KEY STILL DEPRESSED? 
341g: 1D6B 28 F9 iD JSR GETKEY IF YES, RETURN WITH KEY IN ACCU 
3428: ID6E 60 RTS 

3430. 

3440: GETBYT READS 2 HEXKEYS AND COMPOSES 

3456: THEIR VALUES IN THE A REGISTER. IF ONLY 

3468: HEXKEYS WERE DEPRESSED, IT RETURNS WITH 

3476: N=l. IF A COMMAND KEY WAS DEPRESSED, IT 

3488: RETURNES WITH N=8, 

34948: 

3568: 1D6F 28 5C 1D GETBYT JSR SCANA READ HIGH ORDER NIBBLE 
3518: 1D72 c9 1@ CMPIM $18 

35280: 1D74 1@ 11 BPL BYTEND COMMAND KEY? 

3538: 1D76 BA ASLA 

3548: 1D77 OA ASLA IF NOT, SAVE HIGH ORDER NIBBLE 
355@: 1078 @A ASLA 

3568: 1D79 BA ASLA 

35780: ID7A 85 FE STA NIBBLE 

3588: iD7C 2@ 5c ID JSR SCANA READ LOW ORDER NIBBLE 

3598; ID7F c9 1@ CMPIM $16 

3688; 1D81 16 64 BPL BYTEND COMMAND KEY? 

3618: 1D83 85 FE ORA NIBBLE IF NOT, COMPOSE BYTE 

3628: 1D85 A2 FP LDXIM SFF SET N=] 

363@: 1D87 66 BYTEND RTS 

3648: 

3656: SCAND IS A SUBROUTINE SHOWING DATA SPECIFIED BY 
3668: POINT. 

3678: SCANDS IS A SUBROUTINE SHOWING THE CONTENTS OF 
3686: DISPLAY BUFFER AS A FUNCTION OF BYTES. 

3698: THE FOLLOWING SUBROUTINE AK SCANS THE KEYBOARD. 
3708: IT RETURNS WITH A=8, IF NO KEY IS DEPRESSED AND 
3714: WITH A#@ IF A KEY IS DEPRESSED. 

3726: WHEN SCAND OR SCANDS ARE LEFT, PA®...PA7 IS INPUT. 
3736: 

3748: 

37568: 

3768; 

3778: 1088 AB aa SCAND LDYIM $8@ 

3788: 1D8A Bl FA LDAIY POINTL GET DATA SPECIFIED BY POINT 
3798; 1D8Cc 85 F9 STAZ INH 
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3988: 
38190: 
3820: 
3838: 
3848; 
3359; 
386@.: 
3878: 
388@: 
38990; 
3906: 
3918: 
3928, 
3938; 
3949: 
3958; 
3960: 
3978: 
3989; 
3996; 


4088: 


4019: 


4026: 
4038; 
4646: 


4658: 
4668: 
4870: 


4888: 
4698: 


4190: 
411@: 
4128; 
4130: 
41496: 
415@: 
41690: 
4178: 
4180: 


4198: 


4200: 
4218: 
4226: 
4236: 


4246: 
4258: 
4268: 


4278: 


4286: 
4296: 
4388; 


4310: 
4320: 
4334: 
434_8; 


4358: 
4368; 
4378: 
4388: 
4398: 
4480: 
4410: 


4426; 
4438; 


4446; 


4456: 


4460: 


4478: 
4486: 
4496: 
4508: 
45198: 
4520: 


4536: 


4540: 
4556: 
4568; 
4576: 
4580: 
4598: 
4689: 
4618: 
4620: 
4636: 
46486: 
46528: 
4668: 
4676: 
4688: 
4698; 
4760: 
4719: 
4726: 
4734a° 
4749: 
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1ID8E 
1D9@ 
1093 
1095 
1D97 
1D39 
1DS9C 
1D9D 
1D9F 
iDAl 
1DA4 
1DA5 
LDA? 
1DA9 
IDAC 
IDAE 


1DBi 
1DB3 


1D85 
1DB7 
1DBA 
1DBB 
1DBC 
IDBF 
1DCc8 
1DC 2 
1Dc4 
1DC7 
1DC9 
1DCB 


ipcc 
1DCD 
1DCF 
1DDBa 
IpD1l 
1DDd2 
1DD3 
1DD6 
1DD7 
1DD9 
lpoc 
1DDE 


1DDF 
1DE@ 
1DE3 
IDE6 
1DE9 
1DEB 
1DEC 
1DEE 
IDF 
IDF3 
1DF6 
IDF? 
1DF8 


IDF9 
1DFB 
1DFD 
1LEQ6 
1EB2 
1EB4 
1EB6 
1£08 
1LEBS 
1E6B 
1EBC 
EGE 
leer 
LE11 
1E12 
1E14 
1E15 
1E16 


48 
84 
4A 
44 
4A, 
4A 
20 
68 
29 
29 
A4 
66 


AB 
B9 
8D 
8E 
Ag 


18 
8C 
A® 
8c 
E8 


68 


A2 
AB 


Dé 
E6 
DB 
A9 
60 
AQ 
BA 
Be 


14 
BA 
29 
44 
AA 
$8 


86 


F5 
66 
82 
88 
FF 


FC 


DF 


aF 
DF 
FC 


OF 
88 
82 
7F 


FD 
88 
66 
82 


21 
81 
B5 
07 
27 
F5 
15 


FF 
83 
FA 


OF 


LA 


1D 


1D 


1D 


1A 


1A 


1A 


lA 


1B 


1D 


1F 
1A 
1A 


1A 


1A 


1D 


SCANDS LUAIM $7F 
STA PADD PA®...PA6 1S OUTPUT 
LDXIM $#8 ENABLE DISPLAY 
LDYZ BYTES FETCH LENGTH FROM BYTES 
SCDSA LDAZ POINTH OUTPUT 1ST BYTE 
JSR SHOW 


BEQ SCDSB MORE BYTES? 
LDAZ POINTL 


JSR SHOW IF YES, OUTPUT 2ND BYTE 


DEY 
BEQ SCDSB MORE BYTES? 
LDA2 INH 


JSR SHOW IF YES, OUTPUT 32RD BYTE 
SCDSB LDAIM $&@@ 
STA PADD PA®...PA7 IS INPUT 


AK LDYIM $83 SCAN 3 ROWS 
LDXIM $86 RESET ROW COUNTER 
ONEKEY LDAIM S$FF 
AKA STX PBD OUTPUT ROW NUMBER 
INX ENABLE FOLLOWING ROW 
INX 
AND PAD INPUT ROW PATTERN 
DEY ALL ROWS SCANNED? 
BNE AKA 
LDYIM $66 TURN DISPLAY OFF 
STY PBD 
ORAIM $88 SET BIT?=l 
EORIM S$FF INVERT KEY PATTERN 
RTS 


THE SUBROUTINE SHOW TRANSPORTS THE 
CONTENTS OF ANY DISPLAY BUFFER TO THE 
DISPLAY. THE X REGISTER IS USED AS A 
SCAN COUNTER. IT DETERMINES, IF POINTH, 
POINTL OR INH IS TRANSPORTED TO THE 


DISPLAY. 
SHOW PHA SAVE DISPLAY 
STY2 TEMP SAVE Y REGISTER 
LSRA 
LSRA GET RIGH ORDER NIBBLE 
LSRA 
LSRA 
JSR CONVD OUTPUT HIGH ORDER NIBBLE 
PLA GET DISPLAY AGAIN 
ANDIM SOF MASK OFF HIGH ORDER NIBBLE 


JSR CONVD OUTPUT LOW ORDER NIBBLE 
LDYZ TEMP RESTORE Y¥ REGISTER 
RTS 


THE SUBROUTINE CONVD CONTROLS THE DISPLAY SCAN. 
IT CONVERTS THE CONTENTS OF THE DISPLAY BUFFER 
TO BE DISPLAYED INTO A SEGMENT PATTERN. 


CONVD TAY USE NIBBLE AS INDEX 
LDAY LOOK FETCH SEGMENT PATTERN 
STA PAD OUTPUT SEGMENT PATTERN 
STX PBD OUTPUT DIGIT ENABLE 
LDYIM $7F 

DELAY DEY DELAY 5@@ US APPROX, 
BPL DELAY 
STY PAD TURN SEGMENTS OFF 


LDYIM $86 

STY PBD TURN DISPLAY OFF 
INX ENABLE NEXT DIGIT 
INX 

RTS 


GETKEY CONVERTS A DEPRESSED KEY INTO A 
HEX NUMBER. IT RETURNS WITH THE KEY VALUE 
IN ACCU. IF AN INVALID KEY WAS DEPRESSED, 


GETKEY LDXIM $21 START AT ROW @ 

GETKEA LDYIM $81 GET ONE ROW 
JSR ONEKEY A=@, NO KEY DEPRESSED 
BNE KEYIN 


CPXIM $27 

BNE GETKEA EACH ROW SCANNED? 
LDAIM $15 RETURN IF INVALID KEY 
RTS 


KEYIN LDYIM SFF 
KEYINA ASLA 
BCS KEYINB 
INY 
BPL KEYINA 
KEYINB TXA 
ANDIM SOF MASK MSD 
LSRA DEVIDE BY 2 
TAX 
TYA 


SHIFT LEFT UNTIL Y=KEY NUMBER 


4758: 
4768: 
4770: 
4786: 
479@: 
4808: 
4810: 
4828 
4830 
4848 
4858: 
48686: 
4870: 
4880: 
4890: 
4908; 
4919; 
4928; 
4930: 
4940: 
4956: 
4968: 
4976: 
4988: 
499@; 
5806; 
5014: 
50286: 
5638: 
5840: 
5058: 
5868: 
$078: 
5880: 
5698: 
5188: 
5118: 
5128: 
5138: 
5148: 
5158: 
5166: 
5174: 
5188: 
5198: 
5208: 
$216: 
5228: 
5236: 
5248: 
5258: 
5260: 
5278: 
5286: 
5298: 
5308: 
5318: 
5320: 
5336: 
5348: 
53586: 
5368: 
5378: 
5388: 
5399: 
5408: 
541@: 
5428: 
5436: 
5448: 
545@: 
5468; 
5478: 
5488: 
5498; 
5568: 
551@: 
5526: 
5538: 
554@: 
555@: 
556¢; 
$578: 
5588: 
5598: 
5696: 
5616: 
5626: 
5638: 
5648: 
5658: 
5668: 
567¢@: 
5686: 
5698; 


oe be 48 


-LE1? 


1E19 
EIA 
1E1C 
1E1D 
1E1F 


1E2@ 
1E23 
1E25 
1E27 
1E2A 
LE2C¢ 
lE2E 
1£30 
1E 32 
1E35 
1E37 
1E39 
lE3B8 
1E30 
1E48 
1E42 
1E44 
1E 46 


1E4? 
lE4A 
1E4D 
1lE4F 
1E51 
1E53 
1E55 
1E56 
1E5? 
1E59 
1E5B 


LESC 
lE5E 
1E68 
1E62 
1lE64 
1£66 
1E68 
1E6A 
lE6C 
lE6E 
1E7@ 
1E72 
LE74 
1E76 
1E78 
lE7A 
1E7C 
1E7D 
1E8@ 
1E82 


1E83 
1E85 
1E87 
1E89 
1E8B 
1E8D 
1lESF 
1E91 
1E93 
1E35 
1E97 
1E99 
1E9B 
1ES9D 
ESF 
LEA] 
1EA3 
LEAS 


18 
18 
69 
CA 


68 


28 
1@ 
85 
26 
84 
84 
C6 
F@ 
28 
1@ 
85 
C6 
F@ 
28 
18 
85 
A2 
68 


28 
28 
A2 
A@ 
B5 
9} 
CA 
C8 
C4 
Da 
68 


bd 


83 
a7 


FA 


6F 
21 
FB 
68 
Fy 
FD 
Fi 
12 
6F 
OF 
FA 
F? 
87 
6F 
a4 
F9 
FF 


A6 
DC 
B2 
a@ 
F9 
E6 


F6 
F6 


88 
E6 
81 
ad 
1A 
4¢ 
16 
68 
12 
83 
208 
aC 


19 
86 
Or 


le 
F6 


lb 


1E 


1D 


1D 


1E 
1E 


LF 


BPL KEYIND 


KEYINC CLC 

ADCIM $867 ADD ROW OFFSET 
KEYIND DEX 

BNE KEYINC 

RTS 


RDINST TRANSFERS AN INSTRUCTION FROM KEYBOARD 
TO THE DISPLAY BUFFER. IT RETURNS WITH N=@ IF 
A COMMAND KEY WAS DEPRESSED. ONCE THE ENTIRE 

INSTRUCTION IS READ, RDINST RETURNS WITH N=1. 


RDINST JSR GETBYT READ OP CODE 
BPL RDB RETURN, IF COMMAND KEY 
STAZ POINTH STORE OP CODE IN DISPLAY BUFFER 
JSR LENACC COMPUTE INSTRUCTION LENGTH 
STYZ COUNT 
ST¥Z TEMPX 
DEC2 COUNT 


BEG RDA 1 BYTE INSTRUCTION? 
JSR GETBYT IF NOT, READ FIRST OPERAND 
8PL RDB RETURN, IF COMMAND KEY 


STAZ POINTL STORE 1ST OPERAND IN DISPLAY BUFFER 
DEC2Z COUNT 


BEQ RDA 2 BYTE INSTRUCTION? 

JSR GET8YT IF NOT, READ 2ND OPERAND 

BPL RDB RETURN IF COMMAND KEY 

STAZ INH STORE 2ND OPERAND IN DISPLAY BUFFER 
RDA LDOXIM SFF N=1 
RDB RTS 


FILLWS TRANSFERS TRE DATA FROM DISPLAY TO 
WORKSPACE, IT'S ALWAYS LEFT WITH Z=1 


FILLWS JSR DOWN MOVE DATA DOWN 8Y THE AMOUNT IN BYTES 
JSR ADCEND ADJUST CURRENT END ADDRESS 


LDXIM $02 
LDYIM $88 
Ts LDAZX INH FETCH DATA FROM DISPLAY BUFFER 
STAIY CURADL INSERT DATA INTO DATA FIELD 
INY 
CPYZ BYTES ALL INSERTED? 
BNE ws IF NOT, CONTINUE 
RTS 


OPLEN COMPUTES THE LENGTH OF ANY 6582 INSTR. 
THE INSTR, LENGTH IS SAVED IN BYTES. 


OPLEN LDYIM $88 
LDAITY CURADL FETCH OP CODE FROM WS 


LENACC LDYIM $81 LENGTH OF OP CODE IS 1 BYTE 
CMPIM $88 
BEQ LENEND BRK INSTRUCTION? 
CMPIM $48 
BEQ LENEND RTI INSTRUCTION? 
CMPIM $68 
BEOQ LENEND RTS INSTRUCTION? 
LDYIM $63 
CMPIM $28 
BEQ LENEND JSR INSTRUCTION? 
ANDIM SIF STRIP TO 5 BITS 
CMPIM $19 
BEQ LENEND ANY ABS,Y INSTRUCTION? 
ANDIM S@F STRIP TO 4 BITS 
TAX USE NIBBLE AS INDEX 
LDYX LEN FETCH LENGTH FROM LEN 
LENEND STYZ BYTES DISCARD LENGTH IN BYTES 
RTS 


UP MOVES A DATA FIELD BETWEEN CURAD AND CEND 
UPWARD BY THE AMOUNT IN BYTES 


UP LDAZ CURADL 
STAZ MOVADL 
LDAZ CURADH MOVAD: =CURAD 
STAZ MOVADH 
UPLOOP LDYZ BYTES 
LDAIY MOVADL MOVE UPWARD BY THE AMOUNT IN BYTES 
LDYIM $88 
STAITY MOVADL 
INCZ MOVADL 


BNE UPA 
INCZ MOVADH MOVADH: =MOVADH+1 
UPA LDAZ MOVADL 


CMPZ CENDL 

BNE UPLOOP ALL DATA MOVED? 
LDAZ MOVADH IF NOT, CONTINUE 
CMP2 CENDH 

BNE UPLOOP 

RTS 


DOWN MOVES A DATA FIELD BETWEEN CURAD 
AND ENDAD DOWNWARD BY THE AMOUNT IN BYTES 
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57068: 
5716: 
5728: 
5738: 
5746: 
575@: 
5760: 
5778: 
578¢a: 
5798: 
580¢@: 
581d: 
5820: 
5838; 
5842; 
5858; 
5868: 
5878: 
SP Sb: 
5898: 
590@: 
5918: 
592@: 
5936: 
5944: 
5956: 
596@: 
597¢@; 
5380: 
5996: 
€80¢@: 
6018. 
602¢: 
6838: 
66498: 
6058: 
6068: 
o@76: 
6886: 
6098: 
6146: 
6118: 
6128: 
6138: 
6148: 
6158; 
6168: 
6178: 
618¢@: 
6198: 
6200: 
6214: 
62208: 
6234: 
6246: 
6258: 
6268: 
627¢@: 
6288: 
6296: 
6308: 
6318: 
6328: 
6336: 
6348: 
6356: 
6368: 
6376: 
638@: 
6399: 
6496: 
6418: 
6426: 
6430; 
6448: 
6458: 
6468: 
647¢@: 
6489: 
649¢@: 
6508: 
65186: 
652@: 
6538: 
6548; 
6558: 
6568; 
6578: 
6582: 
659@: 
6608: 
661¢@- 
66290: 
6634: 
6642@: 
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1LEAG6 
1EA8 
lEAA 
1LEAC 
1EAE 
1lEBB@ 
1LEB2 
1EB4 
1EB6 
1EB8 
1EBA 
EBC 
1EBE 
LEC@ 
LEC2 
1EC3 
1ECS 
LEC? 
1EC9 
LECB 
LECD 
1LECF 
lED2 


1ED3 
JEDS 
1ED? 
lED9 
lEDB 


JEDC 
JEDD 
LEDF 
1lEE1 
1EE3 
lEES 
1EE? 
1EE9 


1EEA 
JEEB 
LEED 
LEEF 
lEFI 
LEF3 
iEFS 
JEF? 


LEFS8 
LEF9 
LEFB 
LEFD 
LEFF 
1F81 
1F@3 
LEGS 
1FO6 
1F@8 
1F@A 
1F8C 
1F@E 


1FOF 
1F16 
1F1il 
1F12 
1F13 
1lF14 
1F15 
1F16 
1F17 
1F18 
iF19 
1FIA 
iF1B 
lFic 


A5 
85 
A5 
85 
AB 
Bl 
A4 


AS 
c5 
Da 


C5 
FB 


A5 
E9 
85 
AS 
Eg 
85 
4c 
68 


AS 
85 
AS 
85 
68 


18 
A5 
65 
85 
AS 
69 
85 
68 


38 


ES 
85 
AS 
EQ 
85 
68 


18 
AS 
65 
85 
AS 
69 
85 
38 
AS 
E5 
AS 


ES 
68 


E2 
Eb 
E3 
E7 


E8 
F6 
E8 
E9 
ee 
E9 


E8 
F6 
E8 
E9 
08 
E9 


1e€ 


DOWN LDAZ CENDL 
STAZ MOVADL MOVAD: =CEND 
LDAZ CENDH 
STAZ MOVADH 
DNLOOP LDYIM $@@ 
LDAIY MOVADL MOVE DOWNWARD BY THE AMOUNT IN BYTES 
LDY2 BYTES 
STAIY MOVADL 
LDA2 MOVADL 
CMPZ CURADL 
BNE DNA ALL DATA MOVED? 
LDAZ MOVADH IF NCT, CONTINUE 
CMPZ CURADH 
BEQ DNEND 


DNA SEC 
LDOA2Z MOVADL 
SBCIM $#@1 


STAZ MOVASL 
LDAZ2 MOVADH MOVAD: =MOVAD-] 
SBCIM $@8 
STAZ MOVAUH 
JMP DNLOOP 
DNEND RTS 


BEGIN SETS CURAD EQUAL TO BEGAD 


BEGIN LDAZ BEGADL 
STAZ CURADL 
LDAZ BEGADH CURAD: =BEGAD 
STAZ CURADH 
RTS 


ADCEND ADVANCES CURRENT END ADDRESS 
DOWNWARD BY THE AMOUNT IN BYTES 


ADCEND CLC 
LDAZ CENDL 
ADC2 BYTES CEND:=CEND+BYTES 
STAZ CENDL 
LDAZ CENDH 


ADCIM $86 
STAZ CENDH 
RTS 


RECEND REDUCES THE CURRENT END ADDRESS 
BY THE AMOUNT IN BYTES 


RECEND SEC 
LDAZ CENDL 
SBC2 BYTES CEND:=CEND-BYTES 
STAZ CENDL 
LDAZ CENDH 


SBCIM $88 
STAZ CENDH 
RTS 


NEXT ADVANCES THE CURRENT DISPLAYED ADDRES 
DOWNWARD BY THE AMOUNT IN BYTES 


NEXT CLE 
LDAZ CURADL 
ADC2 BYTES CURAD: =CURAD+BYTES 
STAZ CURADL 
LDAZ CURADH 


ADCIM $88 
STAZ CURADH 
SEC 


LDAZ CURADL 
SBCZ CENDL 
LDAZ CURADH 


SBCZ CENDH 
RTS 


THE LOOKUP TABLE "LOOK" IS USED, TO CONVERT 


A HEX NUMBER INTO A 7 SEGMENT PATTERN. 
THE LOOKUP TABLE "LEN" IS USED, TO CONVERT AN 


LiiSTRUCTION INTO AN INSTRUCTION LENGTH. 


LOOK = $48 “an 
= $79 wl 
= $24 wo 
= $3@ ae 
= $19 na" 
= $12 oo 
= $82 "eg" 
= $78 aie 
= $86 “gr 
= $18 agen 
= $a8 ma 
= $83 "Af 
= $46 ewes 
= $21 AE 


6658: 
6668: 
6670; 
6688: 
6696: 
678@: 
6716: 
6728: 
6720: 
6748: 
6758: 
6768: 
6778: 
6786: 
6798; 
680a- 
6618: 
6826; 
6636: 
6848: 
6458: 
6868. 
6876. 
6888: 
6898- 
69409. 
6932: 
69286: 
6938: 
6948: 
6958; 
69628: 
6978: 
6988; 
6998; 
7080: 
7818: 
7820: 
7638: 
7046; 
7256: 
7O6@: 
727@: 
7086 - 
7898: 
7108. 
7114. 
7128; 
7138: 
7148: 
7156: 
7168: 
717@: 
7180: 
7198: 
7208: 
7210; 
7228: 
7238: 
724@- 
7258: 
7266: 
7278: 
7286: 
7290: 
7308; 
7316: 
7328: 
73368: 
73468: 
7358: 
7366: 
7378: 
7380: 
7396: 
7400: 
7418: 
7428: 
743@; 
7448; 
745@: 
7468: 
7478: 
7488: 
749@: 
75088: 
7516: 
752@: 
7538: 
7548: 
7556; 
7568: 
7578: 
7580: 
7598: 


l€ 1b 
1lFIE 


lFIF 
1F 28 
1F2] 
1F22 
LF 23 
iF 24 
125 
1F26 
1F2? 
IF 28 
1F29 
1F2A 
1F 2B 
LF 2C 
1F2D 
lF2E 


1F2F 
1F 32 


1F35 
1637 
1lF 39 
1F 3B 
1F3D 
1F3F 
1F4] 
1F42 
1F 44 
1FP45 
1F 46 
1F 48 
IF4A 


1F 4B 
1F4C 
iP4D 
1F4E 
1P58 


IF51 
lF52 
1F54 
1F56 
1F58 
1FSA 
LFSC 
1FSE 
1F 68 
iF62 


1F65 
1F68 
IF6A 
IF6C 
1F6E 
1F78 
1F71 
1F73 
1F75 
1f77? 
lF78 
1F7A 
1F7C 
lF7D 
LP 7F 


66 
BE. 


G2 
62 
#2 
61 
82 
G2 
82 
81 
Ai 
a2 


81 
Q3 


83 
43 


6c 
6C 


Bl 
AB 
C4 


Gl 
De 
88 
Bl 
AA 
88 
Bi 
A® 
68 


88 
8&8 
88 
De 
68 


7A 1A 


TE iA 


EC 
81 


E9 


LE 


1E 


S860 nee 
$@c Wen 


HoT 


LEN $82 
$62 
$82 
$81 
SB2 
$B2 
$82 
981 
$61 
$A2 
$81 
$8 
$83 
$83 
$63 
$83 


Hof on on Wo Wo oe oh ow ow Ho WoW a 


IMI NMIL JUMP TO A USER SELECTABLE NMI VECTOR 
JMI ERQL JUMP TO A USER SELECTABLE IRQ VECTOR 


GETLBL I5 AN ASSEMBLER SUBROUTINE. IT SEARCHES FOR 
LABELS ON THE SYMBOL PSEUDO STACK. IF THIS STACK 
CONTAINS A VALID LABEL, IT RETURNS WITH THE 

HIGH ORDER LABEL ADDRESS IN X AND THE LOW ORDER LABEL 
ADDRESS IN A, IF NO VALID LABEL IS FOUND, IT RE- 
TURNES WITH Z=l. 


GETLBL LDAIY CURADL FETCH CURRENT LABEL NUMBER FROM WS 
LDYIM $FF RESET PSEUDO STACK 

SYMA CFYZ LABELS UPPER MOST SYMBOL TABLE ADDRESS? 
BEQ SYMB IF YES, RETURN, NO LABEL ON PSEUDO STACK 
CMPIY TABLEL LABEL NR. IN WS = LABEL NR. ON PSEUDO STACK? 
BNE SYMNXT 


DEY IF YES, GET HiGH ORDER ADD 
LDAITY TABLEL 
TAX DISCARD HIGH ORDER ADD IN XK 
DEY 
LDALY TABLEL GET LOW ORDER ADD 
LDYIM $@1 PREPARE Y REGISTER 

SYMB RTS 

SYMNXT DEY RRR HR RK HRKKRKERKER 
DEY * X=ADH * * A=ADL * 
DEY KARR ERK RAK KK RK 
BNE SYMA 
RTS 


ASSEMBLER MAIN ROUTINE 
FOLLOWING INSTRUCTIONS ARE ASSEMBLED; 
JSR INSTRUCTION 


JMP INSTRUCTION 
BRANCH INSTRUCTIONS 


ASSEMB SEC 
LDA2 ENDADL 
SBCIM $FF 


STAZ TABLEL TABLE: =ENDAD-SFF 
LDAZ ENDADH 

SBCIM $88 

STAZ TABLEH 

LDAIM SFF 

STAZ LABELS 

JSR BEGIN CURAD: =BEGAD 


PASSA JSR OPLEN START PASS ONE, GET CURR. INSTR. 


LDYIM $88 

LDALY CURADL FETCH CURRENT INSTRUCTION 
CMPIM SFF IS THE CURRENT INSTR. A LABEL? 
BNE NXTINS 

INY 


LDAIY CURADL IF YES, FETCH LABEL NR. 
LDOYZ LABELS 
STAIY TABLEL DEPOSIT LABEL NR. ON SYMBOL STACK 


LDAZ CURADH GET HIGH ORDER ADD 
STAIY TABLEL DEPOSIT ON SYMBOL STACK 
DEY 

LDAZ CURADL GET LOW ORDER ADD 

STAIY TABLEL DEPOSIT ON SYMBOL STACK 
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LFS] 
1F82 
1F 84 
1F87 
1F8A 


1F8D 
1F96 
1F92 
1F95 
1F98 
1F9A 
1F9C 
IFQE 
1FAG 
1FA2 
1FA4 
1FA6 
1FA8 
1FAA 
1FAD 
1FAF 
1FB1 
1FB3 


1FB6 
1FB? 
1FBA 
1FBC 
1FBE 
iFBF 
1FCB 
1FC2 


1FC4 
LFC5 
1FC8 
LFCA 
1FCB 
1FCD 
1FCE 
1FDG 
1FD2 


LPDS5 
LFD6 
1FD8 
1LFDA 
1FDC 
LFDE 
1FE1 
1FE3 
1FE5 
1FE8 
1FEA 
1FEC 
LFED 
1FEF 
1FF1 
1FF3 
LFF5 


C8 


FQ 
91 
8A 
c8 
91 
Da 


c8 
28 
F@ 
38 
ES 
38 
E9 
91 
4c 


D8 
A9 
85 
85 
85 
28 
18 
85 
20 
18 
85 
18 
AS 
ES 
85 
C6 
4c 


35 
EE 
E6 


£6 
E6 


35 
E® 


E6 


a2 
E6 
AA 


FA 
F9 
6F 
F2 
FB 


EB 
FA 


FA 
FB 
F9 


DE 


LE 
Le 
LE 


1E 
1E 


1E 


1c 


iF 


1lF 


1lF 


iD 


* 1D 


iF 


NXTINS JSR 


PASSB 


PB 


JUMPS 


INY 
JSR 
BEQ 
STATY 
TRA 
INY 
STAIY 
BNE 


BRINST INY 


JSR 
BEQ 
SEC 
SBCZ 
SEC 
SBCIM 
STAIY 
JMP 


$18 
BRINST 
NEXT 
PASSB 
$83 
BYTES 
START 


GETLBL 
PB 
CURADL 


CURADL 
PB 


GETLBL 
PB 
CURADL 
$82 


CURADL 
PB 


ADJUST PSEUDO STACK POINTER 
DELETE CURRENT LABEL IN WS 
ADJUST CURRENT END ADD 

LOOK FOR MORE LABELS 


IF NO LABEL, SKIP TO NEAT INSTR, 
ALL LABELS IN WS COLLECTED? 
START PASS 2 

GET LENGTH OF THE CURRENT INSTR. 


FETCH CURRENT INSTR. 
JMP INSTR. ? 


JSR INSTR.? 


STRIP TO 5 BITS 
ANY BRANCH INSTRUCTION? 


IF NOT, RETGRN 
ALL LABELS BETWEEN CURAD AND ENDAD ASSEMBLED? 


ENABLE 3 DISPLAY BUFFERS 


EXIT HERE KKKKKRK KK 


SET POINTER TO LABEL NR. 
GET LABEL ADD 
RETURN, IF NOT FOUND 


STORE LOW ORDER ADD 


STORE HIGH ORDER ADD 


SET POINTER TO LABEL NR. 
GET LABEL ADD. 
RETURN, IF LABEL NOT FOUND 


COMPUTE BRANCH OFFSET 


DESTINATION-SOURCE-2=OFFSET 
INSERT BRANCH OFFSET IN WS 


THE SUBROUTINE BRANCH COMPUTES THE OFFSET OF BRANCH 


INSTRUCTIONS. 


THE 2 


RIGHT HAND DISPLAYS SHOW THE 


COMPUTED OFFSET DEFINED BY THE 4 LEFT HAND DISPLAYS, 
THE PROGRAM MUST BE STOPPED WITH THE RESET KEY. 


BRANCH CLD 


BR 


LDAIM 
STAZ 
STAZ 
STAZ 
JSR 
BPL 
STAZ 
JSR 
BPL 
STAZ 
CLC 
LDAZ 
SBC2 
STAZ 
DECZ 
JMP 


$86 

POINTH 
POINTL 
INH 

GETBYT 
BRANCH 
POINTH 
GETBYT 
BRANCH 
POINTL 


POINTL 
POINTH 
INH 
INH 

BR 


RESET DISPLAY BUFFER 


READ SOURCE 

COMMAND KEY? 

SAVE SOURCE IN BUFFER 

READ DESTINATION 

COMMAND KEY 

SAVE DESTINATION IN BUFFER 


FETCH DESTINATION 
SUBTRACT SOURCE 


EQUALIZE AND SAVE OFFSET IN BUFFER 


VECTORS AT THE END OF THE MEMORY: 


1FFA 
1FFB 
1FFC 
LFFD 
LFFE 
LFFF 


$2F NMI VECTOR 


S1F 


S1D RESET VECTOR 


$1¢ 


$32 IRQ OR BRK VECTOR 


SIF 


END OF JUNIOR'S MONITOR 


8546: 
855@: 
8560: 
8570: 
85880: 
8598: 
8608: 
8616: 
86286: 
8638; 
8642: 
8658; 
8668: 
8678: 
8688: 
8698: 
8788: 
871: 
8728: 
8730; 
8748: 
875@: 
8768: 
877@: 
8780: 
879@: 
8800: 
8810: 
8826: 
88386: 
88486: 
8858: 
8868: 
8876: 
8880; 


ACC 
ADMODE 
BEGADH 
BRANCH 
CENDH 
CNTB 
CNTF 
COUNT 
DATA 
DNEND 
EDETB 
ENDADH 
FILBUF 
GETKEY 
INH 
IRQH 
KEYINA 
KEY 
LEN 
MOVADH 
NMIH 
OPLEN 
PASSS8 
PCH 
POINTL 
RDF LAG 
SAVE 
SCANA 
SCDSA 
SELOOP 
STARA 
SYMA 
TABLEL 
UPA 
XREG 


BOF3 


1C5C 
BOE 3 
1FO5 
8BE9 
LAFS 
LAFD 
@QF7 
1C 98 
1LED2 
1AE5 
GGE5 
1D51 
1DF9 
GOF9 
LATE 
LEBB 
@GE1 
1lF1F 
Q@EB 
1A7B 
1LE5C 
1F95 
BOFB 
O@FA 
1AD5 
1C8@ 
1D5¢ 
1D97 
1CE2 
1¢38 
1F 39 
QBEC 
1E99 
QOES 


ADCEND 
AK 
BEGADL 
BRINST 
CENDL 
CNTC 
CNTG 
CURADH 
DELAY 
DNLOOP 
EDETD 
ENDADL 
FILLWS 
GETLBL 
INL 
IRQL 
KEYINB 
LABELS 
LOOK 
MOVADL 
NMIL 
PADD 
PB 
PCKEY 
PREG 
RDINST 
SAVEA 
SCANB 
SCDSB 
SHOW 
START 
SYMB 
TEMP 
UPLOOP 
YREG 


LEDC 
1DB1 
BBE2 
1FC4 
@BE8 
1LAFE6 
lAFE 
@@E? 
1DEB 
1EAE 
LAE? 
BGE4 
1E4? 
1F 35 
@QF8 
lA7E 
1E1] 
@@EE 
1F OF 
OBEA 
LATA 
1A81 
1FAA 
1¢7D 
O8F1 
1E28 
1¢85 
1D61 
1DAC 
lpcc 
1033 
1F4A 
OBFC 
LE8B 
OaFr4 


ADDRES 
AKA 
BEGIN 
BYTEND 
CMND 
CNTD 
CNTH - 
CURADL 
DELETE 
DOWN 
EDIT 
ERRA 
GETBYT 
GOEXEC 
INPUT 
JUMPS 


1CA3 
1DB?7 
1ED3 
1087 
1CCA 
lAF? 
lAFF 
BBE6 
1D2C 
LEA6 
1ccé 
1D39 
1D6F 
1c 45 
1Da9 
1FB6 
1E19 
lE6@ 
1c 88 
1EFS8 
1F8D 
1A88 
1A83 
@BEF 
1E44 
lEEA 
1COF 
1D88 
icF1l 
1D21 
1c7@ 
1FP 4B 
8Q8FD 
1AE6 


ADLOOP 
ASSEMB 
BR 
BYTES 
CNTA 
CNTE 
CONVD 
DAMODE 
DNA 
EDETA 
EDITOR 
ERRB 
GETKEA 
ILLKEY 
INSERT 
KEYIN 
KEY IND 
LENEND 
MODE 
NIBBLE 
ONEKEY 
PASSA 
PBD 
POINTH 
RDB 
RESET 
SCAN 
SCANDS 
SEARCH 
SPUSER 
STEPA 
TABLEH 
UP 

ws 


1CA5 
1F51 
1FDE 
GGF6 
1lAF4 
LAFC 
1DDF 
1C66 
LEC2 
1AE4 
1CB5 
1D45 
1DFB 
1c8c 
1CFB 
1E89 
LEC 
1E88 
OOFF 
QOFE 
1DB5 
1F65 
1A82 
8@FB 
1E46 
1¢c1D 
1D4D 
1D8E 
1ccb 
G@F2 
1C7A 
@BED 
1E83 
JES} 
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Appendix 2 


Listings of the programs used 
in chapters 5 and 6 


0E10: 
8820; 
0838: 
0048: 
6058: 
e608: 
BB7O: 
808e: 
6098: 
B1ee: 
81lld@: 
0126: 
6136: 
8148; 
9158: 
6160: 
6178: 
0188: 
81998: 
9200: 
6218: 
6220: 
6238: 
8248: 
0250: 
6268: 
8278: 
8280: 
8298: 
@308: 
0319: 
8328: 
9338: 
0349: 
0358: 
8360: 
0378: 
2388: 
9390: 
@400: 
0419: 
0420: 
8438: 
0448: 
0458: 
8468: 
6478: 
8480: 
8499; 
BSee@: 
0518: 
8528: 
0538: 
8548: 
a558: 
$568: 
8578: 
#588; 
8598: 
06088: 
0618: 
8628: 
@038: 
0640: 
8650: 
8668: 


SYMBOL 
POINTH 


GETBYT 
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9208 


8208 
8200 
8200 
8280 
8288 


8208 


6208 
8282 
8284 
9286 
8288 
628B 
828D 
826F 
8211 
9214 


6217 
8214 
821C 
@21E 
822) 
B223 
6224 
8225 
8227 
8229 
$228 
822D 


622E 
8236 
#232 
8235 
8236 
8238 
823A 


B23B 
82% 
623E 
8240 
8242 
8244 
#246 
8248 
8249 
624C 


AS 
85 
B5 
85 
26 
1d 
85 
85 
28 
IC 


26 
85 
84 
20 
A2 
6A 
CA 
De 
BS 
85 
84 
68 


AG 
84 


18 
AS 
69 
68 


38 
AS 
E9 
85 
AS 
E9 
38 
c8 


68 


00 
PA 


6F 
F3 
F9 
D? 
17 
08 


2E 
PA 
D? 
2E 
84 


6e 
DB 
3B 


Dd? 
8A 


D? 
6A 
DB? 
DB 
Be 
64 


3B 


TABLE 
622E 
8223 
86F9 
@24C 


TABLE 
88D? 
@8FB 
6223 
1D6F 


B2 
a2 


82 


82 


82 


BINARY DECIMAL CONVERS ION 


ORG $8280 
MEMORY CELLS 
INH * $@@F9 DISPLAY BUFFERS 
POINTL * S@BFA 
POINTH * S@OFB 
HEXL * $@9D7 DATA BUFFERS 
HEXH * S8@D8 


MONITOR SUBROUTINE GETBYT 
GETBYT * S1D6F KEYBOARD & DISPLAY SCAN 
START OF DiSPL 


DISPL LDAIM $@@ DISPLAY 68802 


STAZ INU 
STAZ POINT'L 
STAZ POINTH 

DA JSR  GETBYT READ KEYBOARD, SCAN DISPLAY 
BPG DISPL RETURN IF COMMAND KEY 
STAZ INH BYTE TO DISPLAY BUFFER 
STAZ HEXL BYTE TO DATA BUFFER 
JSR  HEXDEC BINARY DECIMAL CONVERSION 
JMP DA WAIT FOR A NEW BYTE 

SUBROUTINES OF THE CONVERSION PROGRAM 

HEXDEC JSR = COMNUM COMPUTE ONES 
STAZ POINTL DISCARD ONES 
STYZ HEXL GET CONTENTS OF THE SUBTRACTION COUNTER 
JSR COMNUM COMPUTE TENS 
LDXIM $@4 SET SHIFT COUNTER 

HD ASLA SHIFT LEFT 
DEX ALL SHIFTS DONE 
BNE HD IF NOT, CONTINUE 
ORAZ POINTL TENS & ONES INTO 1 BYTE 
STAZ POINTL 
STYZ POINTH HUNDREDS TO DISPLAY BUFFER 
RTS 

COMNUM LDYIM $8@ RESET HIGH ORDER HEX BUFFER 
STY2 HEXH 
JSR SUBTRA SUBTRACT Y*SBA 
CLO 
LDAZ HEX CORRECT SUBTRACTION ERROR 
ADCIM $6A 
RTS 

SUBTRA SEC 
LDAZ HEXL 16 BIT SUBTRACTION 
SBCIM $8A 
STAZ HEXL 
LDAZ HEXH 
SBCIM $88 
BMI SUB COMPLETE SUBTRACTION, IF RESULT NEGATIVE 
INY SUBTRACTION COUNTER = Y+] 
JMP SUBTRA CONTINUE SUBTRACTION 

SUB RTS 

END OF DISPL 

DA 8288 DISPL 8260 GETBYT 1D6F 


HEXDEC 6217 HEXH #@D8 HEXL #6D? 
POINTH #@FB POINTL SOFA SUBTRA 923B 


KEXH #8@D8 INH BOF 9 PO'TNTL @OFA 
DISPL 6288 DA 8288 HEXDEC 8217 
COMNUM 822E SUBTRA @23B SUB 924C 


4 


“eid: 


0029: 


0638: 


8688 


6849: 
@858: 
9868: 


Q078: 
BB8e8: 
6896: 
0168: 


BOBO 
8800 
bbde 
8290 


6118: 


G128: 
#138: 
0140: 
8158: 


008 
BaG2 
6865 
ObB6 


di6b: 


817d: 
8188: 
6190: 
62008: 
8210: 
6220: 
0238: 
0248; 
Q258: 


8689 
8BEC 
O8GE 
001d 
6813 
0616 
8817 
Bala 
@61D 


6268: 
82708; 
6288: 


9298: 
6388: 
8318: 
8328: 


9828 
0821 
0822 
6824 


‘9338: 


SYMBOL, 
DELAY 
PADD 


SYMBOL 
DEMO 
PAD 


Az 
8E 
E8 
BE 
AD 


49 
AB 


28 
ac 


26 
4c 


Da 
60 


a6 
81 


83 


88 
FF 
4) 
82 


28 
82 


28 
09 


FD 


TABLE 
8429 
1A81 


TABLE 
0OGR 
1A88 


1A 


1A 
Ob 


oT) 
68 


DEMO ROUTINE 


ORG 


$8880 


1/0 DEFINITION 


PAD x 91488 
PADD * >1A81 
PBD * $1A82 
PeDD * $1483 
DEMO LDXIM $89 
STX PADD 
INX 
STX  PBDD 
FREQ LDA PAD 
BORIM SFF 
LDYIM S82 
STY  PBD 
JSR DELAY 
INY 
STY¥  PBD 
JSR DELAY 
JMP FREQ 
SUBROUTINE DELAY 
DELAY TAX 
DEL DEX 
BNE DEL 
RTS 
DEL G2) DEMO 
PAD 1A80 PBDD 
FREQ 6689 DELAY 
PADD 1A81 PBD 


DATA REGISTER 
DATA DIRECTION REGISTER 
DATA REGISTER 
DATA DIRECTION REGISTER 


PA@...PA7 IS INPUT 
P8¢@ 1S OUTPUT 


READ SWITCH PATTERN 
INVERT PATTERN 

BB IS ZERO 

TOGGLE SPEAKER ON 


DELAY = SWITCHES * LOOP TIME 


TOGGLE SPEAKER OFF 
DELAY = SWITCHES * LOOP TIME 
RETURN 


X-REGISTER 1S THE DELAY COUNTER 
DELAY LOOP 


G888 FREQ #069 
1A83 PBD 1482 


8620 DEL 962) 
1AB82 PBDD =-1483 
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8819: 
8828; 
8036: 
0648: 
6658; 
8868: 
8870: 
8986: 
0698: 
188: 
Gil@: 
0128: 
6138: 
0149: 
0158: 
0168: 
6178: 
8188: 
8196: 
8206: 
8218: 
8228: 
0238; 
0248; 
0258: 
9268: 
8278: 
8288: 
0298: 
0380: 
0319: 
#326: 
6338: 
8349: 
0358: 
0366: 
0370: 
0388: 
6398: 
9408; 
0418: 
9428: 
6438: 
0448: 
9459: 
9466: 
0470: 
0488: 
0498: 
0588: 


SYMBOL TABLE 


6888 


8889 
8896 
Bde 


66a 
88200 
8808 
6888 


0688 
8862 
0685 
6887 
688A 


680D 
@0BF 


6812 
8815 
8817 
@O1A 
81D 
60lF 
6822 


6824 
0826 
8629 
8B2C 
60 2F 
8838 
8832 
8834 
8637 
663A 
88 3D 
60 3F 
6848 
8842 


DELA 
KEYA 


KEYVAL 


PAD 


SYMBOL TABLE 


PLAY 


KEYC 
EQUAL 
DEL 
PBDD 
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Ag 


AQ 
8D 


Ag 


FQ 
81 
a1 
83 
82 
ae 


8D 88 


28 
FO 
26 
26 
FB 
26 
A4 


Ag 
8D 
BE 
28 


De 
Ag 
8D 
BE 
28 
Fe 


DO 
F@ 


Aa 


F3 
44 


69 
82 
Be 


FA 
81 
82 
Be 


D3 


F8 
EB 


BBA6 
004A 


8244 
1A88 


@Q6E 
88D9 
8024 


8608 
893A 
O8B6E 
8894 
BBAA 
1ABE 
1A83 


aS> 


Soe 


PLAY ROUTINE 


ORG 


$0680 


TEMPORARY DATA BUFFERS IN PAGE ZERO 


ROW : 
KEY . 
TEMPX * 


$88D9 
SOBDA 
$88DB 


I/O DEFINITION 


PAD * 
PADD * 
PBD 
PBDD * 
PLAY LDAIM 
STA 
LDAIM 
STA 
STA 
LDAIM 
STA 
PA JSR 
BEQ 
JSR 
JSR 
BEQ 
JSR 
LDYZ 
TONE LDAIM 
STA 
LDXY 
TA JSR 
DEX 
BNE 
LDAIM 
STA 
LDXY 
TR soJSR 
BEQ 
DEX 
BNE 
BEQ 
DELAY @66A4 
KEYB 0063 
KEY BEDA 
PBDD 1A83 
ROWB 078 
TA 2B2C 
PA @012 
KEYVAL 0044 
ROWB 0078 
KEYIN @@9C 
ROW -BADY 
PAD —-1A88 


$1486 
$1A81 
S1A82 
$1A83 


SFO 
PADD 
38) 
PBDO 
PBD 


$B 
PAD 


KEYIN 
PA 
DELAY 
KEYIN 
PA 
KEYVAL 
KEY 


$68 
PBD 
DEL 
EQUAL 


TA 
$01 
PBD 
DEL 
KEYIN 
PA 


TB 
TONE 


DEL 
KEYC 


PBD 


TONE 
KEYA 


DELAY 


PADD 


ROW BUFFER 
KEY VALUE BUFFER 
ROW NUMBER BUFFER 


PA7?...PA4 IS OUTPUT 
PA3...PA@ IS INPUT 


Pag IS OUTHUT 
TOGGLE SPEAKER OFF 


ALL MATRIX ROWS ARE ZERO 


ANY KEY DEPRESSED? 
BRANCH, IF NO 
DEBOUNCE THE KEY 

KEY STILL DEPRESSED 
IF YES, CONTINUE 
COMPUTE THE KEY VALUE 
GET KEY VALUE 


BB = 8 

TOGGLE SPEAKER ON 

FETCH THE FREQUENCY 
EQUALIZE 22 MICRO SEC. 
HALF PERIODE PASSED? 
WAIT, IF NOT 

Bd = 1 

TOGGLE SPEAKER OFF 

FETCH THE FREQUENCY AGAIN 
ANY KEY STILL DEPRESSED? 
IF YES, GENERATE A TONE 
HALF PERIODE PASSED? 
WAIT, IF NOT 

CONTINUE, IF YES 


1Ab8 EQUAL BAA 
8094 KEYIN @89C 


8612 PADD 1481] 
1A82 PLAY  689@ 


8882 ROWD = @B8C 
083A TEMPX §$@8DB 


8824 TA 88 2C 
BG4A KEYB 4863 
B82 ROWD = 888C 
BOA4 DELA 6646 
@2DA TEMPX @@DB 
1481 PBD 1A82 


00le: 
6026; 
0230; 
B48; 
0858: 
@069: 
6870: 
6088: 
8898: 
0198: 
g@1l@: 
9128: 
8138: 
9148: 
6158: 
0168: 
@176: 
8186: 
6196; 
6206: 
6218: 
82298: 
$234: 
0248: 
6258: 
6268: 
O278: 
0280: 
8290: 
6388: 
6318: 
0328: 
0336: 
0348: 
6358; 
8368: 
0378: 
6388; 
6398: 
8460: 
64198: 
8426: 
8430: 
6448: 
6450: 
@460: 
6478: 
0480: 
8498; 
8588: 
6518: 
8528: 
#538; 
0548: 
6558: 
6568: 
@578: 
0588: 
0598: 
8680: 
8618: 
6628: 
6630: 
6648: 
9658: 
9660: 
6678: 
8688: 
6692: 
0788: 
6718: 
0728: 
$732; 
0748: 
0758: 
8766: 
0778: 
0786: 
8790: 
68a0: 
6818: 
8828: 
0839: 
6848: 
Q858: 
O868: 
0876: 
a8e8e: 
g89e: 
0988: 
6919; 
0928: 
8938: 
8948: 


6644 
8846 
8648 
684A 
664B 
64D 
O04F 
6851 
6654 
8857 
6059 
$853 
665D 
Q@O5F 
9a61 
0863 
6865 
B267 
6868 
BB6A 
BEC 
@B6E 
8876 
8872 
0a74 
8075 


6678 
667A 
907C 
867D 
867E 
8888 


8282 
8284 
8086 
$687 
8888 
868A 


888C 
6@8E 
8098 
9891 
8892 


8694 
6896 
8898 
869B 


889C 
8G9F 
@BA1 
8BA3 


BOA4 
BOA6 
BBA? 
BAAS 


OBAA 
OBAB 
BBAC 
BBAD 
AQAE 
BOAF 


iA@e 


Age 
1AGi 
JAB2 
1A83 
1A84 
1A@5 
1A06 
1A67 
1A68 
JA89 
1AGA 
1A9B 
1A8C 
1A8D 
AGE 
LAOF 


AS 
A2 


36 
86 
AS 
8D 


29 
cg 
FB 
86 
85 
A2 
46 
98 
E8 


De 
Fe 
A5 
cg 
De 


cg 
De 


is 
69 
DB 


cg 
DB 


18 
69 
De 


cg 
De 


18 
69 


85 
Ag 
8D 
68 


8E 
86 
7E 
77 
70 


64 
5E 
39 
54 
4E 


47 
43 
3E 


94 


B2 
66 


84 
12 


61 
86 
b8 
a8 


Ad 
B4 


bb 
88 


88 
@F 
OF 
PF 


FD 


Be 


66 


SUBROUTINES OF THE PLAY PROGRAM 


KEYVAL LDAIM $F7 


KEYA 


KEYC 


KEYIN 


DELAY 
DELA 


STAZ 
LDXIM 
DEX 
BMI 
ASL2Z 
LDAZ 
STA 
LDA 
ANDIM 
CMPIM 
BEQ 
STXZ 
STAZ 
LDXIM 
LSRZ 
BCC 
INX 
CPXIM 
BNE 
BEQ 
LDAZ 
CMPIM 
BNE 
TXA 
JMP 


CMPIM 
BNE 


ADCIM 


CMPIM 


CLe 
ADCIM 


STAZ 


STA 
RES 


LDA 
ANDIM 
EORIM 


LDYIM 
DEY 
BNE 
RTS 


NOP 
NOP 
NOP 
NOP 
NOP 
RTS 


ORG 


ROW 
$04 


KEYVAL 


KEY 
$88 
KEY 
ROWA 
$04 
KEYVAL 


$83 
ROWB 


KEYC 
$82 
ROWC 


$@4 
KEYC 


$61 


$88 
KEYC 


$60 
KEYVAL 
$8C 


KEY 
$80 


PAD 
SOF 
$F 


SFF 


DELA 


S1AG6 


ALL ROWS ARE ONE 


SET UP ROW COUNTER 
RETURN IF INVALID ROW 
IS FOUND 

SPECIFIED ROW IS ZERO 


OUTPUT ROW HUMBER 

IF NO KEY IS DEPRESSED IN THE 
SPECIFIED ROW, OUTPUT 

NEXT ROW NUMBER 


SAVE ROW NUMBER 
SAVE COLUMN NUMBER 


SHIFT UNTIL CARRY CLEAR 
BRANCH TO COMPUTE KEY VALUE 


ALL ROWS SCANNED? 
IF NOT CONTINUE 
RETURN IF INVALID ROW NUMBER 


GET ROW NUMBER AGAIN 
ROW 0? 


ROW 1? 


ROW 2? 


ROW 3? 
RETURN, IF ROW IS INVALID 


SAVE KEY VALUE 
RESET PORT A 


MASK OFF HIGH ORDER NIBBLE 


IF NO KEY: ACCU = $8B 


SET DELAY COUNTER 


TIME OUT ? 


EQUALIZE 28 MICRO SEC 


FREQUENCY LOOKUP TABLE 


DEL 


END OF 


rund t boobed ob ae ww RoR OD 


PLAY 


$8E 
$86 
STE 
$77 
$78 
S6A 
$64 
$SE 
$59 
$54 
$4E 
S4A 
$47 
$43 
$3E 
$3C 
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8218: 
8820: 
8836: 
8648; 
8858: 
#868: 
0876: 
0988: 
0696: 
6168: 
811a: 
0128: 
8138: 
0149: 
6158: 
0168; 
8178: 
$18@: 
9198: 
A280: 
6210: 
9228- 
6238: 
8248: 
A258: 
B268: 
6278: 
6288: 
0298; 
6388: 
9318: 
8328: 
8338: 
8348: 
9358: 
6368: 
8376: 
0388; 
8398: 
6400- 
0416: 
2426: 
6430; 
6440: 
2456: 
0468: 
6478: 
6488: 
0496: 
6598: 
65198: 
8520: 
0538: 
0546: 
6558: 
8568: 
O578; 
6580: 
8598: 
0628: 
0618: 
0620; 
R630: 
0648: 
9658: 
6669: 
6672: 
8688: 
8698: 
6788: 
0718: 
0726: 
8738: 
0748: 
0758: 
8768: 
8778; 
8788: 
6798: 
e808: 
6819: 
0828: 
6838: 
8849; 
8858; 
6868: 
6878: 
8888: 
8896: 
8908: 
8919: 
0928- 
6938: 
0948; 
6958: 


208 


6208 


8266 
8206 
208 
6280 
8288 
8208 
8288 


8268 
8208 


8200 


8208 
0288 
8280 
8288 


6268 
6208 


6282 
8281 
6262 
8284 
8287 
4269 
826C 
B28E 
8211 
9213 
8216 
8219 
821B 
@21D 
8228 
8222 
8224 
0226 
8228 
B22A 
822B 
822D 
822F 
B232 
4234 
9237 
823A 
823C¢ 
823F 
824] 
8243 
8245 
8248 
8249 
6248 
B24D 
8258 
8253 
8256 
0257 
8259 
$25B 
B25E 
B26i 
4264 
6266 
6267 
8269 
826B 
A26E 
8276 
9272 
8274 
Q@275 
8277 
8279 
827A 


78 
D8 
A9 
8D 
AQ 
8D 


AQ 


28 
7E 


TF 
FO 
81 
Gi 
83 
82 


88 
86 


D8 
DF 
7? 


FF 
F9 
EB 


E8 
E@ 
F3 
88 
A 
DE 
FF 
FE 


80 
82 
88 
EE 


FA 
Ql 


88 
E@ 
65 
F8 


E@ 
P4 


ll 
Be 


DE 


Sb & B & 


> 


82 


@2 
82 


B2 


92 


nb & 


1A 


INPUT ROUTINE 


ORG S#28# 


TEMPORARY DATA BUFFERS IN PAGE ZERO 


ROW * S$B2D9 
KEY * $82DA 
TEMPX * $@@DB 
NOTEL * $88DC 
NOTEH * $88DD 
LENGTH * SOBDE 
ENDL * S8ODF 


INTERVAL TIMER 


CNTA * SLAF4 
CNTG * S1AFE 
GOTO MONITOR 

RESET * $1C1D 


I/O DEFINITION 


NOTE POINTER 


TIME OF A DEPRESSED KEY 
END OF THE NOTE BUFFER 


DISABLE TIMER IRQ 
ENABLE TIMER IRQ, CLK64T 


NEW I/O DEFINITION 


PAD * $1A86 
PADD * $1A81 
PBD * S1A82 
PBDD * $1A83 
IRQ VECTOR 
IRQ. * S1A7E 
IRQH * SIA7TF 
START OF THE INPUT PROGRAM 
INPUT SEI DISABLE IRQ LINE 
CLD 
LDAIM IRQIN SET UP IRQ VECTOR 
STA = IRQL 
LDAIM IRQIN /256 
STA IRQH 
LDAIM SF@ PA7?,..PA4 IS OUTPUT, PA3...PA@ IS INPUT 
STA PADD 
LDAIM $@1 
STA PBDD- PB# IS OUTPUT FOR SPEAKER 
STA PBD TOGGLE SPEAKER OFF 
STAZ NOTEH HIGH ORDER BYTE OF NOTE POINTER 
LDYIM $88 
STY PAD SET ALL ROWS 2ERO 
STYZ NOTEL LOW ORDER BYTE OF NOTE POINTER 
LDYEM $D8 DEFINE ENDADDRESS OF INPUT BUFF'ER 
STYZ ENDL 
LDAIM $77 LOAD BOF CHARACTER 
INA STATY NOTEL FILLUP WORKSPACE WITH EOFS 
DEY 
CPYIM SFF WS FILLED UP? 
BNE INA, IF NOT CONTINUE 
KEYSCN JSR KEYIN ANY KEY DEPRESSED? 
BEQ KEYSCN WAIT IF NO KEY IS DEPRESSED 
JSR DELAY DEBOUNCE KEYBOARD 
JSR KEYIN STILL ANY KEY DEPRESSED 
BEQ  KEYSCN IF YES, CONTINUE 
JSR  KEYVAL COMPUTE KEY NUMBER 
LDAIM $88 
STAZ LENGTH RESET TIME COUNTER 
LDAIM SFF START TIMER, ENABLE TIMER IRQ, 
STA CNTG - RESET IRQ LINE 
CLI ENABLE IRQ LINE 
EDY2 KEY LOOKUP CONVERSION BY KEY VALUE 
TONE LDAIM $88 TOGGLE SPEAKER ON 
STA PSD PBe IS LOG 8 
LDXY DEL FETCH DELAY 
TA JSR EQUAL EQUALIZE 28 MIKRO SEC 
DEX 
BNE TA DELAY 
LDAIM $#@1 TOGGLE SPEAKER OFF 
STA PSD 
LDXY DEL FETCH DELAY AGAIN 
TB JSR  KEYIN ANY KEY STILL DEPRESSED? 
BEQ STORE BRANCH IF KEY IS RELEASED 
DEX 
BNE TS 
BEQ TONE CONTINUE AS LONG AS A KEY IS DEPRESSED 
STORE STA CNIA RESET IRQ LINE,DISABLE TIMER IRQ 
LDAZ NOTEL 
CMPZ ENDL IS WORKSPACE FULL? 
BEQ ST If YES, EXIT HERE 
TYA 
LDYIM $0é 
STAIY NOTEL STORE KEY VALUE IN WS 
INY ; 
LOAZ LENGTH GET TIME OF THE DEPRESSED KEY 


@96e: 
e978: 
0988: 
0990: 
1608: 
181¢@: 
6016: 
8028: 
0038: 
0649: 
2658: 
O069: 
0878: 
@680: 
9898: 
0108: 
0118: 
012¢: 
#130: 
0146: 
6150: 
6166: 
8176: 
0188: 
6196: 
8208: 
6218: 
0220: 
0230: 
8240: 
0258: 
8260: 
B27B: 
8298: 
#290: 
8300: 
8318: 
6328: 
8338: 
8346: 
8358: 
8368: 
0378: 
8388: 
8398: 
0488: 
8416: 
8426: 
0436: 
0440: 
8456: 
8468: 
8478: 
0480: 
8490; 
0500; 
6518: 
8528; 
0538: 
0540: 
a55p; 
0568: 
0578: 
8588: 
8598: 
8608: 
#618: 
8628: 
0630: 
0648: 
8658: 
0668: 
0678: 
0688: 
0696: 
2786: 
@71¢8: 


627C 
827E 
8288 
8282 
0285 


9288 
828A 
@28C 
O28E 
Q28F 
8291 
8293 
8295 
8298 
6298 
829D 
@29F 
82Ai 
@2A3 
@2A5 
@247 
82A9 
Q@2AB 
B2AC 
Q2AE 
02Be 
82B2 
82B4 
82B6 
8288 
@2B9 


82BC 
82BE 
82CB 
#2C1 
@2C2 
@2C4 


@2C6 
82C8 
B2CA 
82CB 
82CC 
@2CE 


@2D9 
62D2 
@2D4 
62D5 
B2D6 


@2D8 
A2DA 
@2DC 
@2DF 


G2E8 
82E3 
G2E5 
Q@2E7 


82E8 
B2EA 
6258 
O82ED 


62EE 
B2EF 
B2F8 
B2F1 
B2F2 
82F3 


91 
E6 
E6 


AQ 
A2 


38 
06 
A5 
8D 


29 
C9 
Fa 
86 
85 
A2 
46 
98 
E8 
E@ 
De 
Fe 
AS 
Cy 
De 


cy 
De 


18 
69 
ba 


cg 
Db 


18 
69 
De 


cg 
De 


18 
69 


8S 
AQ 
8D 
68 


@2 
86 


84 
12 
Qi 
66 
08 
a8 
ae 
B4 


ac 


4) 
88 


88 
OF 
OF 


FF 


FD 


82 
Ic 


BS 


ST 


STALY NOTEL 
INCZ2 NOTEL 
INC2 NOTEL 
JMP  KEYSCN 
JMP RESET 


STORE KEY TIME IN WS 
ADJUST NOTE POINTER 


BACK TO MONITOR 


SUBROUTINES OF THE INPUT PROGRAM 


KEYVAL LDAIM $F? 


KEYA 


KEYB 


KEYC 


KEYIN 


DELAY 


DELA 


EQUAL 


STAZ ROW 
LDXIM $04 
DEX 

BMI KEYVAL 
ASLZ ROW 
LDAZ ROW 
STA PAD 
LDA = PAD 
ANDIM SOF 
CMPIM SOF 
BEQ  KEYA 
STXZ TEMPX 
STAZ KEY 
LDXIM $80 
LSRZ KEY 
BCC ROW 
INX 

CPXIM $@4 
BNE KEYB 
BEQ KEYVAL 
LDAZ TEMPX 
CMPIM $@3 
BNE ROWB 
TRA 

JMP KEYC 
CMPIM $82 
BNE ROW 
TXA 

Cle 

ADCIM S64 
BNE KEYC 
CMPIM $81 
BNE ROWD 
TXA 

cIlL 

ADCIM $88 
BNE KEYC 
CMPIM $88 
BNE KEYVAL 
TXA 

Cle 

ADCIM $8C 
STAZ KEY 
LDAIM $8é 
STA PAD 
RTS 

LDA = PAD 
ANDIM S@F 
PBORIM S@F 
RTS 

LDYIM SFF 
DEY 

BNE DELA 
RTS 

NOP 

NOP 

NOP 

NOP 

NOP 

RTS 


ALL ROWS ARE ONE 


SET UP ROW COUNTER 
RETURN IF INVALID ROW 
IS FOUND 

SPECIFIED ROW IS ZERO 


OUTPUT ROW NUMBER 

IF NO KEY IS DEPRESSED IN THE 
SPECIFIED ROW, OUTPUT 

NEXT ROW NUMBER 


SAVE ROW NUMBER 
SAVE COLUMN NUMBER 


SHIFT UNTIL CARRY CLEAR 
BRANCH TO COMPUTE KEY VALUE 


ALL ROWS SCANNED? 
IF NOT CONTINUE 
RETURN If INVALID ROW NUMBER 


GET ROW NUMBER AGAIN 
ROW @? 


ROW 1? 


ROW 2? 


ROW 3? 
RETURN, IF ROW IS INVALID 


SAVE KEY VALUE 
RESET PORT A 


MASK OFF HIGH ORDER NIBBLE 
IF NO KEY: ACCU = $08 


SET DELAY COUNTER 


TIME OUT ? 


EQUALIZE 28 MICRO SBC 
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8720: 


1Ab6 


8738: 
8748: 
@758: 


8768: 
0778: 
8788: 
8798: 
08ee: 
B8la: 
8829: 
9838: 
8848: 
0859: 
8868: 
e876: 
0888; 
9890: 
99280: 
6918: 


1A86 
1481 
1A82 
1A83 
1AB4 
1A@5 
1A86 
1407 
1408 
1AB9 
LABA 
1A6B 
AK 
1A@D 
1ABE 
lAGF 


8928: 
8938: 


0948: 


6956: 
6968: 
8978: 


6988: 
0998: 
16e@: 
1818: 
1828: 
1036: 


1A26 
1A21 
1A23 
1A25 
1A28 
1A29 


1048: 
1858: 


KEYSCN 


TEMPX 


SYMBOL 


NOTEH 


KEYA 


DELAY 
IRQIN 
PADD 
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@2E8 
6228 
1A7E 
@2E8 
@@DE 
1A8@ 
62B2 
Q8D9 
0261 


@BDC 
8208 
@253 
@288 
@2BC 
@2E8 
1A8@ 
1A88 
LAF 4 


ORG S1A80 

FREQUENCY LOOKUP TABLE 
8E DEL = $8 
86 = $86 
7E = STE 
77 = $77 
7@ = $78 
6A = S6A 
64 = $64 
5E =  S5E 
59 = $59 
54 = $54 
aE = SAE 
4a = —-S4A 
a7 = $47 
43 = $43 
3B = -S3E 
3c = $x 

ORG S1A20 

TIMER INTERRUPT PROGRAM 
48 IRQIN PHA SAVE ACCU 
E6 DE INCZ LENGTH INCREMENT TIME 
AQ FE LDAIM SFF TIMER OFFSET IS SPF 
8D FE 1A STA CNTG START TIMER AGAIN 
68 PLA RESTORE ACCU 
ae RTI 

END OF INPUT 
TABLE 
AFA CNTG «= IAFE-—s«DELA ss @2EA_—sCDELAY 
1A@0 = ENDL. «ODF = EQUAL, «@2EE.—sINA 
6200 «6 IRQH «CLA?F~—sIRQIN 1A20— IROL 
B28E KEYB @2A? KEYC @208 —KEYIN 
@22F  KEYVAL. 6288 KEY ODA LENGTH 
@@DD NOTEL @ODC PADD 1A81 PAD 
1A83. PBD-Ss«1AB2_~—s RESET «CID = ROWA 
@2BC = ROW 82C6 ROWD 8208S ROW 
8285 STORE 6268 TA 6253 TB 
@0pB = TONE = 0248 
TABLE 
@@D9_ «KEY —s SODA TEMPX =80DB —NOTEL 
B@DD LENGTH @BDE = ENDL « @@DF_— INPUT 
@228  KEYSCN @22F TONE 6248 = 1A 
8261 STORE 268 ST 8285  KEYVAL 
@28E  KEYB @2A7 OWA 282 ROWE 
@2c6 ROWD @2D@ KEYC @2D8 —KEYIN 
B2E8 = DELA)« @2EA 0 EQUAL @2EE DEL 
W286 IROL) «= IA7E~—SIRQHsJA7F PAD 
1A81 = PBD-Ss«AS2—s PBDD-sJAS83-— CTA 
IAFE = RESET 1C1D 


9918: 
0820: 
8038: 
6046: 
8858: 
6860: 
0070: 
Oe8e: 
0090: 
8109: 
gil@: 
8128: 
0138: 
#148: 
9159: 
@i6@: 
0170: 
0188: 
@198: 
0289: 
6218: 
6220: 
6230: 
6248: 
6250: 
#268: 
@270: 
8288: 
0298; 
0380; 
8318: 
6320: 
6330; 
6348: 
6350: 
03698: 
a378; 
0380: 
0390: 
0400: 
G418: 
6420: 
6430: 
6440: 
8450: 
0460: 
0478: 
8488: 
0490: 
0580: 
0514: 
0528: 
0538: 
0540: 
0558: 
6560: 
0576: 
6588: 
6596: 
8698: 
96198: 
0628: 
0630: 
0640: 
0658: 
8668; 
8670: 
0688: 
8690: 
6708: 
6716: 
8728: 
8738: 
9748: 
8758: 
0768: 
0778: 
0788: 
8798: 
0320: 
0816: 
0826: 
0830: 
8848: 
6858: 
8868: 
6878: 
8886: 
6898: 
8968; 
6918; 


BEGO 


6880 
8628 
6008 
6680 


0868 
8980 
8880 
6080 


8880 


8698 
0088 


8820 
6880 


6680 
8881 
8862 
6064 
6687 
8889 
@88C 
BB9E 
B@11 
0014 
0816 
8818 
BO1A 
881D 


OB1E 
6828 
0823 
6825 
8827 
8829 
602A 
B82C 
BB2E 


9636 
8832 
6035 
6838 
6838 
883C 
603E 
6048 
8843 
8046 
6848 
BB 4A 
84D 
GO4E 
8856 
8852 
8654 
0856 


6859 
OSC 
685E 
605F 
6861 
8863 
6865 
8267 
9869 
8868 
8B6D 


78 
D8 
Ag 
8D 
Ag 
8D 
Ag 
8D 
8D 
85 
Ag 
85 
8D 
58 


AQ 
8D 
Ag 
Bl 
85 
c8 
Bl 
85 
Aa 


AS 
8D 
BE 
28 
CA 
De 
Ag 
8D 
BE 
A5 
38 
28 
CA 
De 
F@ 
A2 
Ag 
8D 


2c 
18 
CA 
DO 
E6 
E6 
Ag 
Bl 
c9 
De 
4c 


30 
7E 


TF 
81 
83 
82 
DD 
68 


F4 


FF 


ae 


DE 


BB 
82 
i ) 
78 


PA 


82 
] 


68 
74 


F6 
DE 
B4 
38 
F7 


EURSRRS 


ip 


So b 


S 


ab > 


ic 


REPEAT ROUTINE 
ORG $6888 


TEMPORARY DATABUFFERS IN PAGE ZERO 


KEY * S@BDA 
NOTEL * SBBDC 
NOTEH * $890D 
LENGTH * SQODE 


INTERVAL TIMER 


CNTA * SIAF4 DISABLE TIMER IRQ 

CNTD * SIAF7 DISABLE TIMER IRQ, CLKIKT 
CNTIG * SIAFE ENABLE TIMER IRQ, CLK64T 
RDFLAG * SIAD5 B? IS TIMER FLAG 

GOTO MONITOR 

RESET * $1C1D NEW I/O DEFINITION 


1/O DEFINITION 


PBD = $1482 
PBDD * $1483 
IRQ VECTOR 


IRQL * SLATE 
IRQH * SLATE 


START OF THE REPEAT PROGRAM 


REPEAT SEI DISABLE IRQ LINE 
CLD 
LDAIM IRQRE SET UP IRQ VECTOR 
STA TROL 
LDAIM IRORE /256 
STA  IRQH 
LDAIM $81 PBA IS OUTPUT 
STA PBDD 


STA PBD TOGGLE SPEAKER OFF 

STAZ NOTEH SET NOTE POINTER 

LDAIM $88 

STAZ NOTEL SET NOTE POINTER 

STA CNTA RESET IRQ LINE, DISABLE TIMER IRQ 
CLI ENABLE CPU IRQ 


FETCH LDAIM SEF SET TIMER ENABLE TIMER IRQ 
STA  CNTG 
LDYIM $8@ FETCH NOTE 
LDAIY NOTEL 
STAZ KEY 
INY FETCH LENGTH 


STAZ LENGTH 
LDYZ KEY LOOKUP CONVERSION 


TONE LDAIM $66 TOGGLE SPEAKER ON 
STA = PBD 
LDOXY DEL GET FREQUENCY 
TONEA JSR EQUALA DELAY 22 MICRO SEC 


BNE TONEA LOOP TIME IS 27 MIKRO SEC*X 
LDAIM $61 TOGGLE SPEAKER OFF 
STA PBD 
LDXY DEL GET FREQUENCY AGAIN 
TONEB LDAZ LENGTH GET LENGTH 
BMI TONEC TIME OUT? 
JSR EQUALB EQUALIZE 17 MICRO SEC 


BNE TONEB LOOP TIME IS 27 MICRO SEC*X AGAIN 
BEQ TONE RETURN AFTER ONE PERIODE 

TONEC LDXIM $@4 LOOP TIME = 4*CNTD*PRESET 

TONED LDAIM $38 PRESET = $38 
STA CNTD DISABLE TIMER IRQ 


POLL BIT RDFLAG READ FLAG REGISTER, TIME OUT? 
BPL POLL IS TIMER FLAG STILL ZERO? 
DEX 
BNE TONED LOOP COUNTER ZERO? 

INC2 NOTEL ADJUST NOTE POINTER 
INC2Z NOTEL 

LDYIM $88 

LDATY NOTEL END OF NOTE BUFFER? 
CMPIM $77 BOP CHARACTER 

BNE FETCH IF NOT BOF, CONTINUE 
JMP RESET ELSE BACK TO MONITOR 
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6014: 
2028: 
0638: 
6648: 
@65¢: 
6B6@: 
8878: 
BB8e: 
6698: 
0168: 
6118: 
G128: 
9138: 
@14B6: 
81598: 
8168; 
B178: 
aise: 
8198: 
02080: 
8218: 
92290; 
0238: 
9248: 
0258: 
6268: 
6270: 
8288: 
6296: 
6308: 
63186: 
9328: 
0338: 
0348: 
8358: 
8368: 
8378: 
8388: 
0399: 
8400: 
0418: 
9429: 
8438: 
6442: 


6878 
6671 
6074 
6875 
6878 


1468 


1A80 
1Aé1 
1A82 
1A83 
1Ab4 
1A85 
1AG6 
1AQ7 
1A68 
1Ag89 
LAGA 
1AgB 
1A0c 
lAéD 
lAGE 
1ABF 


1A38 
1A31 
1A33 
1A35 
1A38 
1A39 


SYMBOL 
CNTA 


IRQH 


PBD 
RESET 


SYMBOL 
REPEAT 


BQUALA 


TROQRE 
PBDD 
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74 08 
78 62 


aa&Sase 


8E 
86 
7E 
7? 
70 


64 
5E 
59 
54 
4E 


47 
43 
3E 


48 

C6 DE 

AQ FF 

8D FE 1A 
68 

48 


TABLE 
1AF4 
8678 
1A7F 
8BDE 
1A82 
1¢1p 
9852 


TABLE 
8908 
8046 
0876 
88DC 
1430 
1A83 
APE 


SUBROUTINES OF THE REPEAT PROGRAM 


17/22 MICRO SEC SUBROUTINE 


1AGB 
@Q1E 
@BDA 
1483 
8808 
8646 


8838 
8853 
@ODA 
1A68 
1A82 
AF? 


EQUALA NOP 
JMP EQUALB 
EQUALB NOP 
JMP  EEND 
EEND RTS 
ORG = $1A86 
FREQUENCY LOOKUP TABLE 
DEL = $8E 
= $86 
= STE 
= $77 
= $76 
= S6A 
= $64 
= SSE 
= $59 
= $54 
= $4E 
= SaA 
= $47 
= $43 
= $3E 
= $x 
ORG = $1A36 
TIMER INTERRUPT PROGRAM 
TRQRE PHA SAVE ACCU 
DBCZ LENGTH DECREMENT TIME 
LDAIM SFF TIMER OFFSET IS SFF 
STA CNIG START TIMER AGAIN 
PLA RESTORE ACCU 
RTI 
END OF REPEAT 
CNTD AF? CNTG JAFE DEL 
EQUALA #8878 EQUALB #274 FETCH 
IROL LATE IRORE 1A38 KEY 
NOTEH #@DD NOTEL ®8@DC PBDD 
POLL 9@59 RDFLAG 1AD5 REPEAT 
TONE #830 TONEA 6238 TONEB 
TONED #054 
FETCH @@1E TONE 68328 TONEA 
TONEC 6852 TONED 9854 POLL 
EQUALB 4874 EEND 878 KEY 
NOTEHK #@DD LENGTH @@DE DEL 
IRQL JA7E IRQH JA7F PRD 
RDFLAG 1AD5 CNTA lAF4 CNTD 
RESET iCl1D 


